Secrets

Store or update a secret

put/v1/vaults/{vault_id}/secrets/{path}

Request

  • Base URL: https://api.1claw.co
  • URL: https://api.1claw.co/v1/vaults/{vault_id}/secrets/{path}
  • Auth: HTTP bearer

Path parameters

vault_idstring uuid required
pathstring required

Secret path (e.g. "db/credentials")

Request body

typestring

Secret type (generic, password, api_key, certificate, private_key, ssh_key, env)

valuestring required
metadataobject
expires_atstring date-time
rotation_policyobject
max_access_countinteger

Response

Secret created or updated

idstring uuid required
pathstring required
typestring required
versioninteger required
metadataobject
created_atstring date-time required
expires_atstring date-time
client_sharestring

Base64-encoded client key share. Returned only for MPC 2-of-2 vaults. The client must store this share securely — it is not persisted server-side.

Changes

No recorded changes to this operation across all 2 revisions of this API.