List Vaults

$ ant beta:vaults list

GET/v1/vaults

List Vaults

Parameters

--include-archived: optional boolean

Query param: Whether to include archived vaults in the results.

--limit: optional number

Query param: Maximum number of vaults to return per page. Defaults to 20, maximum 100.

formatint32

--page: optional string

Query param: Opaque pagination token from a previous list_vaults response.

--beta: optional array of AnthropicBeta

Header param: Optional header to specify the beta version(s) you want to use.

--workspace-id: optional string

Header param: Optional header to select the Workspace for this request. The value is a Workspace ID (for example, wrkspc_011CZkZaBF1tNoB5wlCeusgy).

Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace.

Returns

BetaManagedAgentsListVaultsResponse: object{ data, next_page }

Response containing a paginated list of vaults.

data: optional array of BetaManagedAgentsVault { type: "vault", id, archived_at, 4 more }

List of vaults.

type: "vault"

id: string

Unique identifier for the vault.

archived_at: string

A timestamp in RFC 3339 format

formatdate-time

created_at: string

A timestamp in RFC 3339 format

formatdate-time

display_name: string

Human-readable name for the vault.

metadata: map[string]

Arbitrary key-value metadata attached to the vault.

updated_at: string

A timestamp in RFC 3339 format

formatdate-time

next_page: optional string

Pagination token for the next page, or null if no more results.

List Vaults

ant beta:vaults list \
  --api-key my-anthropic-api-key

Response 200

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

Returns Examples

Response 200

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