Repository Public
1---2title: List Vaults3url: https://platform.claude.com/docs/en/api/beta/vaults/list4---56# List Vaults78**GET** `/v1/vaults`910List Vaults1112## Query parameters1314- `include_archived: optional boolean`1516 Whether to include archived vaults in the results.1718- `limit: optional number`1920 Maximum number of vaults to return per page. Defaults to 20, maximum 100.2122 format: int322324- `page: optional string`2526 Opaque pagination token from a previous `list_vaults` response.2728## Headers2930- `"anthropic-beta": optional array of AnthropicBeta`3132 Optional header to specify the beta version(s) you want to use.3334 - `string`3536 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`3738 - `"message-batches-2024-09-24"`3940 - `"prompt-caching-2024-07-31"`4142 - `"computer-use-2024-10-22"`4344 - `"computer-use-2025-01-24"`4546 - `"pdfs-2024-09-25"`4748 - `"token-counting-2024-11-01"`4950 - `"token-efficient-tools-2025-02-19"`5152 - `"output-128k-2025-02-19"`5354 - `"files-api-2025-04-14"`5556 - `"mcp-client-2025-04-04"`5758 - `"mcp-client-2025-11-20"`5960 - `"dev-full-thinking-2025-05-14"`6162 - `"interleaved-thinking-2025-05-14"`6364 - `"code-execution-2025-05-22"`6566 - `"extended-cache-ttl-2025-04-11"`6768 - `"context-1m-2025-08-07"`6970 - `"context-management-2025-06-27"`7172 - `"model-context-window-exceeded-2025-08-26"`7374 - `"skills-2025-10-02"`7576 - `"fast-mode-2026-02-01"`7778 - `"output-300k-2026-03-24"`7980 - `"user-profiles-2026-03-24"`8182 - `"user-profiles-2026-08-18"`8384 - `"user-profiles-2026-09-04"`8586 - `"advisor-tool-2026-03-01"`8788 - `"managed-agents-2026-04-01"`8990 - `"cache-diagnosis-2026-04-07"`9192 - `"dreaming-2026-04-21"`9394 - `"thinking-token-count-2026-05-13"`9596 - `"server-side-fallback-2026-06-01"`9798 - `"server-side-fallback-2026-07-01"`99100 - `"fallback-credit-2026-06-01"`101102 - `"fallback-credit-2026-07-01"`103104 - `"agent-memory-2026-07-22"`105106 - `"mid-conversation-tool-changes-2026-07-01"`107108 - `"compact-2026-01-12"`109110 - `"computer-use-2025-11-24"`111112 - `"mcp-tunnels-2026-06-22"`113114 - `"structured-outputs-2025-11-13"`115116 - `"task-budgets-2026-03-13"`117118 - `"thinking-display-updates-2026-08-18"`119120 - `"ce-user-management-2026-07-13"`121122 - `"mid-conversation-output-config-2026-07-01"`123124 - `"thinking-binding-controls-2026-08-01"`125126 - `"mid-conversation-system-clear-at-2026-08-21"`127128 - `"compact-2026-09-04"`129130- `"anthropic-workspace-id": optional string`131132## Returns133134- `data: optional array of BetaManagedAgentsVault`135136 List of vaults.137138 - `type: "vault"`139140 - `id: string`141142 Unique identifier for the vault.143144 - `archived_at: string or null`145146 A timestamp in RFC 3339 format147148 format: date-time149150 - `created_at: string`151152 A timestamp in RFC 3339 format153154 format: date-time155156 - `display_name: string`157158 Human-readable name for the vault.159160 - `metadata: map[string]`161162 Arbitrary key-value metadata attached to the vault.163164 - `updated_at: string`165166 A timestamp in RFC 3339 format167168 format: date-time169170- `next_page: optional string or null`171172 Pagination token for the next page, or null if no more results.173174## Example175176```bash177curl https://api.anthropic.com/v1/vaults \178 -H 'anthropic-version: 2023-06-01' \179 -H 'anthropic-beta: managed-agents-2026-04-01' \180 -H "X-Api-Key: $ANTHROPIC_API_KEY"181```182183### Response (200)184185```json186{187 "data": [188 {189 "id": "vlt_011CZkZDLs7fYzm1hXNPeRjv",190 "archived_at": null,191 "created_at": "2026-03-15T10:00:00Z",192 "display_name": "Example vault",193 "metadata": {194 "environment": "production"195 },196 "type": "vault",197 "updated_at": "2026-03-15T10:00:00Z"198 }199 ],200 "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo="201}202```203