Sign in

Create Vault

post/v1/vaults?beta=true

Headers

anthropic-versionstring
anthropic-betastring

Request body

display_namestring required

Human-readable name for the vault. 1-255 characters.

metadataobject

Arbitrary key-value metadata to attach to the vault. Maximum 16 pairs, keys up to 64 chars, values up to 512 chars.

Example request

{
  "display_name": "Example vault",
  "metadata": {
    "environment": "production"
  }
}

Response

Successful response (OK)

type'vault' required
idstring required

Unique identifier for the vault.

display_namestring required

Human-readable name for the vault.

metadataobject required

Arbitrary key-value metadata attached to the vault.

created_atstring date-time required

A timestamp in RFC 3339 format

updated_atstring date-time required

A timestamp in RFC 3339 format

archived_atstring date-time required

A timestamp in RFC 3339 format

Example response

{
  "type": "vault",
  "id": "vlt_011CZkZDLs7fYzm1hXNPeRjv",
  "display_name": "Example vault",
  "metadata": {
    "environment": "production"
  },
  "created_at": "2026-03-15T10:00:00Z",
  "updated_at": "2026-03-15T10:00:00Z",
  "archived_at": null
}

Changes

Changed in 2 of the 67 revisions of this API.3

  • d2b230555b7f2See the full diff
    • ○

      removed BetaTimestamp from the archived_at response property allOf list for the response status 200

      response-property-all-of-removed

    • ○

      added BetaTimestamp subschema #2 to the archived_at response property anyOf list for the response status 200

      response-property-any-of-added

  • 69486316563e1See the full diff
    • ○

      endpoint added

      endpoint-added