Repository Public
1---2title: Vaults3url: https://platform.claude.com/docs/en/api/beta/vaults4---56# Vaults78## Create Vault910**POST** `/v1/vaults`1112Create Vault1314### Headers1516- `"anthropic-beta": optional array of AnthropicBeta`1718 Optional header to specify the beta version(s) you want to use.1920 - `string`2122 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`2324 - `"message-batches-2024-09-24"`2526 - `"prompt-caching-2024-07-31"`2728 - `"computer-use-2024-10-22"`2930 - `"computer-use-2025-01-24"`3132 - `"pdfs-2024-09-25"`3334 - `"token-counting-2024-11-01"`3536 - `"token-efficient-tools-2025-02-19"`3738 - `"output-128k-2025-02-19"`3940 - `"files-api-2025-04-14"`4142 - `"mcp-client-2025-04-04"`4344 - `"mcp-client-2025-11-20"`4546 - `"dev-full-thinking-2025-05-14"`4748 - `"interleaved-thinking-2025-05-14"`4950 - `"code-execution-2025-05-22"`5152 - `"extended-cache-ttl-2025-04-11"`5354 - `"context-1m-2025-08-07"`5556 - `"context-management-2025-06-27"`5758 - `"model-context-window-exceeded-2025-08-26"`5960 - `"skills-2025-10-02"`6162 - `"fast-mode-2026-02-01"`6364 - `"output-300k-2026-03-24"`6566 - `"user-profiles-2026-03-24"`6768 - `"user-profiles-2026-08-18"`6970 - `"user-profiles-2026-09-04"`7172 - `"advisor-tool-2026-03-01"`7374 - `"managed-agents-2026-04-01"`7576 - `"cache-diagnosis-2026-04-07"`7778 - `"dreaming-2026-04-21"`7980 - `"thinking-token-count-2026-05-13"`8182 - `"server-side-fallback-2026-06-01"`8384 - `"server-side-fallback-2026-07-01"`8586 - `"fallback-credit-2026-06-01"`8788 - `"fallback-credit-2026-07-01"`8990 - `"agent-memory-2026-07-22"`9192 - `"mid-conversation-tool-changes-2026-07-01"`9394 - `"compact-2026-01-12"`9596 - `"computer-use-2025-11-24"`9798 - `"mcp-tunnels-2026-06-22"`99100 - `"structured-outputs-2025-11-13"`101102 - `"task-budgets-2026-03-13"`103104 - `"thinking-display-updates-2026-08-18"`105106 - `"ce-user-management-2026-07-13"`107108 - `"mid-conversation-output-config-2026-07-01"`109110 - `"thinking-binding-controls-2026-08-01"`111112 - `"mid-conversation-system-clear-at-2026-08-21"`113114 - `"compact-2026-09-04"`115116- `"anthropic-workspace-id": optional string`117118### Body parameters119120- `display_name: string`121122 Human-readable name for the vault. 1-255 characters.123124 minLength: 1, maxLength: 255125126- `metadata: optional map[string]`127128 Arbitrary key-value metadata to attach to the vault. Maximum 16 pairs, keys up to 64 chars, values up to 512 chars.129130### Returns131132- `BetaManagedAgentsVault object`133134 A vault that stores credentials for use by agents during sessions.135136 - `type: "vault"`137138 - `id: string`139140 Unique identifier for the vault.141142 - `archived_at: string or null`143144 A timestamp in RFC 3339 format145146 format: date-time147148 - `created_at: string`149150 A timestamp in RFC 3339 format151152 format: date-time153154 - `display_name: string`155156 Human-readable name for the vault.157158 - `metadata: map[string]`159160 Arbitrary key-value metadata attached to the vault.161162 - `updated_at: string`163164 A timestamp in RFC 3339 format165166 format: date-time167168### Example169170```bash171curl https://api.anthropic.com/v1/vaults \172 -H 'Content-Type: application/json' \173 -H 'anthropic-version: 2023-06-01' \174 -H 'anthropic-beta: managed-agents-2026-04-01' \175 -H "X-Api-Key: $ANTHROPIC_API_KEY" \176 -d '{177 "display_name": "Example vault",178 "metadata": {179 "environment": "production"180 }181 }'182```183184#### Response (200)185186```json187{188 "id": "vlt_011CZkZDLs7fYzm1hXNPeRjv",189 "archived_at": null,190 "created_at": "2026-03-15T10:00:00Z",191 "display_name": "Example vault",192 "metadata": {193 "environment": "production"194 },195 "type": "vault",196 "updated_at": "2026-03-15T10:00:00Z"197}198```199200## List Vaults201202**GET** `/v1/vaults`203204List Vaults205206### Query parameters207208- `include_archived: optional boolean`209210 Whether to include archived vaults in the results.211212- `limit: optional number`213214 Maximum number of vaults to return per page. Defaults to 20, maximum 100.215216 format: int32217218- `page: optional string`219220 Opaque pagination token from a previous `list_vaults` response.221222### Headers223224- `"anthropic-beta": optional array of AnthropicBeta`225226 Optional header to specify the beta version(s) you want to use.227228 - `string`229230 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`231232 - `"message-batches-2024-09-24"`233234 - `"prompt-caching-2024-07-31"`235236 - `"computer-use-2024-10-22"`237238 - `"computer-use-2025-01-24"`239240 - `"pdfs-2024-09-25"`241242 - `"token-counting-2024-11-01"`243244 - `"token-efficient-tools-2025-02-19"`245246 - `"output-128k-2025-02-19"`247248 - `"files-api-2025-04-14"`249250 - `"mcp-client-2025-04-04"`251252 - `"mcp-client-2025-11-20"`253254 - `"dev-full-thinking-2025-05-14"`255256 - `"interleaved-thinking-2025-05-14"`257258 - `"code-execution-2025-05-22"`259260 - `"extended-cache-ttl-2025-04-11"`261262 - `"context-1m-2025-08-07"`263264 - `"context-management-2025-06-27"`265266 - `"model-context-window-exceeded-2025-08-26"`267268 - `"skills-2025-10-02"`269270 - `"fast-mode-2026-02-01"`271272 - `"output-300k-2026-03-24"`273274 - `"user-profiles-2026-03-24"`275276 - `"user-profiles-2026-08-18"`277278 - `"user-profiles-2026-09-04"`279280 - `"advisor-tool-2026-03-01"`281282 - `"managed-agents-2026-04-01"`283284 - `"cache-diagnosis-2026-04-07"`285286 - `"dreaming-2026-04-21"`287288 - `"thinking-token-count-2026-05-13"`289290 - `"server-side-fallback-2026-06-01"`291292 - `"server-side-fallback-2026-07-01"`293294 - `"fallback-credit-2026-06-01"`295296 - `"fallback-credit-2026-07-01"`297298 - `"agent-memory-2026-07-22"`299300 - `"mid-conversation-tool-changes-2026-07-01"`301302 - `"compact-2026-01-12"`303304 - `"computer-use-2025-11-24"`305306 - `"mcp-tunnels-2026-06-22"`307308 - `"structured-outputs-2025-11-13"`309310 - `"task-budgets-2026-03-13"`311312 - `"thinking-display-updates-2026-08-18"`313314 - `"ce-user-management-2026-07-13"`315316 - `"mid-conversation-output-config-2026-07-01"`317318 - `"thinking-binding-controls-2026-08-01"`319320 - `"mid-conversation-system-clear-at-2026-08-21"`321322 - `"compact-2026-09-04"`323324- `"anthropic-workspace-id": optional string`325326### Returns327328- `data: optional array of BetaManagedAgentsVault`329330 List of vaults.331332 - `type: "vault"`333334 - `id: string`335336 Unique identifier for the vault.337338 - `archived_at: string or null`339340 A timestamp in RFC 3339 format341342 format: date-time343344 - `created_at: string`345346 A timestamp in RFC 3339 format347348 format: date-time349350 - `display_name: string`351352 Human-readable name for the vault.353354 - `metadata: map[string]`355356 Arbitrary key-value metadata attached to the vault.357358 - `updated_at: string`359360 A timestamp in RFC 3339 format361362 format: date-time363364- `next_page: optional string or null`365366 Pagination token for the next page, or null if no more results.367368### Example369370```bash371curl https://api.anthropic.com/v1/vaults \372 -H 'anthropic-version: 2023-06-01' \373 -H 'anthropic-beta: managed-agents-2026-04-01' \374 -H "X-Api-Key: $ANTHROPIC_API_KEY"375```376377#### Response (200)378379```json380{381 "data": [382 {383 "id": "vlt_011CZkZDLs7fYzm1hXNPeRjv",384 "archived_at": null,385 "created_at": "2026-03-15T10:00:00Z",386 "display_name": "Example vault",387 "metadata": {388 "environment": "production"389 },390 "type": "vault",391 "updated_at": "2026-03-15T10:00:00Z"392 }393 ],394 "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo="395}396```397398## Get Vault399400**GET** `/v1/vaults/{vault_id}`401402Get Vault403404### Path parameters405406- `vault_id: string`407408### Headers409410- `"anthropic-beta": optional array of AnthropicBeta`411412 Optional header to specify the beta version(s) you want to use.413414 - `string`415416 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`417418 - `"message-batches-2024-09-24"`419420 - `"prompt-caching-2024-07-31"`421422 - `"computer-use-2024-10-22"`423424 - `"computer-use-2025-01-24"`425426 - `"pdfs-2024-09-25"`427428 - `"token-counting-2024-11-01"`429430 - `"token-efficient-tools-2025-02-19"`431432 - `"output-128k-2025-02-19"`433434 - `"files-api-2025-04-14"`435436 - `"mcp-client-2025-04-04"`437438 - `"mcp-client-2025-11-20"`439440 - `"dev-full-thinking-2025-05-14"`441442 - `"interleaved-thinking-2025-05-14"`443444 - `"code-execution-2025-05-22"`445446 - `"extended-cache-ttl-2025-04-11"`447448 - `"context-1m-2025-08-07"`449450 - `"context-management-2025-06-27"`451452 - `"model-context-window-exceeded-2025-08-26"`453454 - `"skills-2025-10-02"`455456 - `"fast-mode-2026-02-01"`457458 - `"output-300k-2026-03-24"`459460 - `"user-profiles-2026-03-24"`461462 - `"user-profiles-2026-08-18"`463464 - `"user-profiles-2026-09-04"`465466 - `"advisor-tool-2026-03-01"`467468 - `"managed-agents-2026-04-01"`469470 - `"cache-diagnosis-2026-04-07"`471472 - `"dreaming-2026-04-21"`473474 - `"thinking-token-count-2026-05-13"`475476 - `"server-side-fallback-2026-06-01"`477478 - `"server-side-fallback-2026-07-01"`479480 - `"fallback-credit-2026-06-01"`481482 - `"fallback-credit-2026-07-01"`483484 - `"agent-memory-2026-07-22"`485486 - `"mid-conversation-tool-changes-2026-07-01"`487488 - `"compact-2026-01-12"`489490 - `"computer-use-2025-11-24"`491492 - `"mcp-tunnels-2026-06-22"`493494 - `"structured-outputs-2025-11-13"`495496 - `"task-budgets-2026-03-13"`497498 - `"thinking-display-updates-2026-08-18"`499500 - `"ce-user-management-2026-07-13"`501502 - `"mid-conversation-output-config-2026-07-01"`503504 - `"thinking-binding-controls-2026-08-01"`505506 - `"mid-conversation-system-clear-at-2026-08-21"`507508 - `"compact-2026-09-04"`509510- `"anthropic-workspace-id": optional string`511512### Returns513514- `BetaManagedAgentsVault object`515516 A vault that stores credentials for use by agents during sessions.517518 - `type: "vault"`519520 - `id: string`521522 Unique identifier for the vault.523524 - `archived_at: string or null`525526 A timestamp in RFC 3339 format527528 format: date-time529530 - `created_at: string`531532 A timestamp in RFC 3339 format533534 format: date-time535536 - `display_name: string`537538 Human-readable name for the vault.539540 - `metadata: map[string]`541542 Arbitrary key-value metadata attached to the vault.543544 - `updated_at: string`545546 A timestamp in RFC 3339 format547548 format: date-time549550### Example551552```bash553curl https://api.anthropic.com/v1/vaults/$VAULT_ID \554 -H 'anthropic-version: 2023-06-01' \555 -H 'anthropic-beta: managed-agents-2026-04-01' \556 -H "X-Api-Key: $ANTHROPIC_API_KEY"557```558559#### Response (200)560561```json562{563 "id": "vlt_011CZkZDLs7fYzm1hXNPeRjv",564 "archived_at": null,565 "created_at": "2026-03-15T10:00:00Z",566 "display_name": "Example vault",567 "metadata": {568 "environment": "production"569 },570 "type": "vault",571 "updated_at": "2026-03-15T10:00:00Z"572}573```574575## Update Vault576577**POST** `/v1/vaults/{vault_id}`578579Update Vault580581### Path parameters582583- `vault_id: string`584585### Headers586587- `"anthropic-beta": optional array of AnthropicBeta`588589 Optional header to specify the beta version(s) you want to use.590591 - `string`592593 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`594595 - `"message-batches-2024-09-24"`596597 - `"prompt-caching-2024-07-31"`598599 - `"computer-use-2024-10-22"`600601 - `"computer-use-2025-01-24"`602603 - `"pdfs-2024-09-25"`604605 - `"token-counting-2024-11-01"`606607 - `"token-efficient-tools-2025-02-19"`608609 - `"output-128k-2025-02-19"`610611 - `"files-api-2025-04-14"`612613 - `"mcp-client-2025-04-04"`614615 - `"mcp-client-2025-11-20"`616617 - `"dev-full-thinking-2025-05-14"`618619 - `"interleaved-thinking-2025-05-14"`620621 - `"code-execution-2025-05-22"`622623 - `"extended-cache-ttl-2025-04-11"`624625 - `"context-1m-2025-08-07"`626627 - `"context-management-2025-06-27"`628629 - `"model-context-window-exceeded-2025-08-26"`630631 - `"skills-2025-10-02"`632633 - `"fast-mode-2026-02-01"`634635 - `"output-300k-2026-03-24"`636637 - `"user-profiles-2026-03-24"`638639 - `"user-profiles-2026-08-18"`640641 - `"user-profiles-2026-09-04"`642643 - `"advisor-tool-2026-03-01"`644645 - `"managed-agents-2026-04-01"`646647 - `"cache-diagnosis-2026-04-07"`648649 - `"dreaming-2026-04-21"`650651 - `"thinking-token-count-2026-05-13"`652653 - `"server-side-fallback-2026-06-01"`654655 - `"server-side-fallback-2026-07-01"`656657 - `"fallback-credit-2026-06-01"`658659 - `"fallback-credit-2026-07-01"`660661 - `"agent-memory-2026-07-22"`662663 - `"mid-conversation-tool-changes-2026-07-01"`664665 - `"compact-2026-01-12"`666667 - `"computer-use-2025-11-24"`668669 - `"mcp-tunnels-2026-06-22"`670671 - `"structured-outputs-2025-11-13"`672673 - `"task-budgets-2026-03-13"`674675 - `"thinking-display-updates-2026-08-18"`676677 - `"ce-user-management-2026-07-13"`678679 - `"mid-conversation-output-config-2026-07-01"`680681 - `"thinking-binding-controls-2026-08-01"`682683 - `"mid-conversation-system-clear-at-2026-08-21"`684685 - `"compact-2026-09-04"`686687- `"anthropic-workspace-id": optional string`688689### Body parameters690691- `display_name: optional string or null`692693 Updated human-readable name for the vault. 1-255 characters.694695 minLength: 1, maxLength: 255696697- `metadata: optional map[string] or null`698699 Metadata patch. Set a key to a string to upsert it, or to null to delete it. Omitted keys are preserved.700701### Returns702703- `BetaManagedAgentsVault object`704705 A vault that stores credentials for use by agents during sessions.706707 - `type: "vault"`708709 - `id: string`710711 Unique identifier for the vault.712713 - `archived_at: string or null`714715 A timestamp in RFC 3339 format716717 format: date-time718719 - `created_at: string`720721 A timestamp in RFC 3339 format722723 format: date-time724725 - `display_name: string`726727 Human-readable name for the vault.728729 - `metadata: map[string]`730731 Arbitrary key-value metadata attached to the vault.732733 - `updated_at: string`734735 A timestamp in RFC 3339 format736737 format: date-time738739### Example740741```bash742curl https://api.anthropic.com/v1/vaults/$VAULT_ID \743 -H 'Content-Type: application/json' \744 -H 'anthropic-version: 2023-06-01' \745 -H 'anthropic-beta: managed-agents-2026-04-01' \746 -H "X-Api-Key: $ANTHROPIC_API_KEY" \747 -d '{748 "display_name": "Example vault",749 "metadata": {750 "environment": "production"751 }752 }'753```754755#### Response (200)756757```json758{759 "id": "vlt_011CZkZDLs7fYzm1hXNPeRjv",760 "archived_at": null,761 "created_at": "2026-03-15T10:00:00Z",762 "display_name": "Example vault",763 "metadata": {764 "environment": "production"765 },766 "type": "vault",767 "updated_at": "2026-03-15T10:00:00Z"768}769```770771## Delete Vault772773**DELETE** `/v1/vaults/{vault_id}`774775Delete Vault776777### Path parameters778779- `vault_id: string`780781### Headers782783- `"anthropic-beta": optional array of AnthropicBeta`784785 Optional header to specify the beta version(s) you want to use.786787 - `string`788789 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`790791 - `"message-batches-2024-09-24"`792793 - `"prompt-caching-2024-07-31"`794795 - `"computer-use-2024-10-22"`796797 - `"computer-use-2025-01-24"`798799 - `"pdfs-2024-09-25"`800801 - `"token-counting-2024-11-01"`802803 - `"token-efficient-tools-2025-02-19"`804805 - `"output-128k-2025-02-19"`806807 - `"files-api-2025-04-14"`808809 - `"mcp-client-2025-04-04"`810811 - `"mcp-client-2025-11-20"`812813 - `"dev-full-thinking-2025-05-14"`814815 - `"interleaved-thinking-2025-05-14"`816817 - `"code-execution-2025-05-22"`818819 - `"extended-cache-ttl-2025-04-11"`820821 - `"context-1m-2025-08-07"`822823 - `"context-management-2025-06-27"`824825 - `"model-context-window-exceeded-2025-08-26"`826827 - `"skills-2025-10-02"`828829 - `"fast-mode-2026-02-01"`830831 - `"output-300k-2026-03-24"`832833 - `"user-profiles-2026-03-24"`834835 - `"user-profiles-2026-08-18"`836837 - `"user-profiles-2026-09-04"`838839 - `"advisor-tool-2026-03-01"`840841 - `"managed-agents-2026-04-01"`842843 - `"cache-diagnosis-2026-04-07"`844845 - `"dreaming-2026-04-21"`846847 - `"thinking-token-count-2026-05-13"`848849 - `"server-side-fallback-2026-06-01"`850851 - `"server-side-fallback-2026-07-01"`852853 - `"fallback-credit-2026-06-01"`854855 - `"fallback-credit-2026-07-01"`856857 - `"agent-memory-2026-07-22"`858859 - `"mid-conversation-tool-changes-2026-07-01"`860861 - `"compact-2026-01-12"`862863 - `"computer-use-2025-11-24"`864865 - `"mcp-tunnels-2026-06-22"`866867 - `"structured-outputs-2025-11-13"`868869 - `"task-budgets-2026-03-13"`870871 - `"thinking-display-updates-2026-08-18"`872873 - `"ce-user-management-2026-07-13"`874875 - `"mid-conversation-output-config-2026-07-01"`876877 - `"thinking-binding-controls-2026-08-01"`878879 - `"mid-conversation-system-clear-at-2026-08-21"`880881 - `"compact-2026-09-04"`882883- `"anthropic-workspace-id": optional string`884885### Returns886887- `BetaManagedAgentsDeletedVault object`888889 Confirmation of a deleted vault.890891 - `type: "vault_deleted"`892893 - `id: string`894895 Unique identifier of the deleted vault.896897### Example898899```bash900curl https://api.anthropic.com/v1/vaults/$VAULT_ID \901 -X DELETE \902 -H 'anthropic-version: 2023-06-01' \903 -H 'anthropic-beta: managed-agents-2026-04-01' \904 -H "X-Api-Key: $ANTHROPIC_API_KEY"905```906907#### Response (200)908909```json910{911 "id": "vlt_011CZkZDLs7fYzm1hXNPeRjv",912 "type": "vault_deleted"913}914```915916## Archive Vault917918**POST** `/v1/vaults/{vault_id}/archive`919920Archive Vault921922### Path parameters923924- `vault_id: string`925926### Headers927928- `"anthropic-beta": optional array of AnthropicBeta`929930 Optional header to specify the beta version(s) you want to use.931932 - `string`933934 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`935936 - `"message-batches-2024-09-24"`937938 - `"prompt-caching-2024-07-31"`939940 - `"computer-use-2024-10-22"`941942 - `"computer-use-2025-01-24"`943944 - `"pdfs-2024-09-25"`945946 - `"token-counting-2024-11-01"`947948 - `"token-efficient-tools-2025-02-19"`949950 - `"output-128k-2025-02-19"`951952 - `"files-api-2025-04-14"`953954 - `"mcp-client-2025-04-04"`955956 - `"mcp-client-2025-11-20"`957958 - `"dev-full-thinking-2025-05-14"`959960 - `"interleaved-thinking-2025-05-14"`961962 - `"code-execution-2025-05-22"`963964 - `"extended-cache-ttl-2025-04-11"`965966 - `"context-1m-2025-08-07"`967968 - `"context-management-2025-06-27"`969970 - `"model-context-window-exceeded-2025-08-26"`971972 - `"skills-2025-10-02"`973974 - `"fast-mode-2026-02-01"`975976 - `"output-300k-2026-03-24"`977978 - `"user-profiles-2026-03-24"`979980 - `"user-profiles-2026-08-18"`981982 - `"user-profiles-2026-09-04"`983984 - `"advisor-tool-2026-03-01"`985986 - `"managed-agents-2026-04-01"`987988 - `"cache-diagnosis-2026-04-07"`989990 - `"dreaming-2026-04-21"`991992 - `"thinking-token-count-2026-05-13"`993994 - `"server-side-fallback-2026-06-01"`995996 - `"server-side-fallback-2026-07-01"`997998 - `"fallback-credit-2026-06-01"`9991000 - `"fallback-credit-2026-07-01"`10011002 - `"agent-memory-2026-07-22"`10031004 - `"mid-conversation-tool-changes-2026-07-01"`10051006 - `"compact-2026-01-12"`10071008 - `"computer-use-2025-11-24"`10091010 - `"mcp-tunnels-2026-06-22"`10111012 - `"structured-outputs-2025-11-13"`10131014 - `"task-budgets-2026-03-13"`10151016 - `"thinking-display-updates-2026-08-18"`10171018 - `"ce-user-management-2026-07-13"`10191020 - `"mid-conversation-output-config-2026-07-01"`10211022 - `"thinking-binding-controls-2026-08-01"`10231024 - `"mid-conversation-system-clear-at-2026-08-21"`10251026 - `"compact-2026-09-04"`10271028- `"anthropic-workspace-id": optional string`10291030### Returns10311032- `BetaManagedAgentsVault object`10331034 A vault that stores credentials for use by agents during sessions.10351036 - `type: "vault"`10371038 - `id: string`10391040 Unique identifier for the vault.10411042 - `archived_at: string or null`10431044 A timestamp in RFC 3339 format10451046 format: date-time10471048 - `created_at: string`10491050 A timestamp in RFC 3339 format10511052 format: date-time10531054 - `display_name: string`10551056 Human-readable name for the vault.10571058 - `metadata: map[string]`10591060 Arbitrary key-value metadata attached to the vault.10611062 - `updated_at: string`10631064 A timestamp in RFC 3339 format10651066 format: date-time10671068### Example10691070```bash1071curl https://api.anthropic.com/v1/vaults/$VAULT_ID/archive \1072 -X POST \1073 -H 'anthropic-version: 2023-06-01' \1074 -H 'anthropic-beta: managed-agents-2026-04-01' \1075 -H "X-Api-Key: $ANTHROPIC_API_KEY"1076```10771078#### Response (200)10791080```json1081{1082 "id": "vlt_011CZkZDLs7fYzm1hXNPeRjv",1083 "archived_at": null,1084 "created_at": "2026-03-15T10:00:00Z",1085 "display_name": "Example vault",1086 "metadata": {1087 "environment": "production"1088 },1089 "type": "vault",1090 "updated_at": "2026-03-15T10:00:00Z"1091}1092```10931094## Domain types10951096### Beta Managed Agents Deleted Vault10971098- `BetaManagedAgentsDeletedVault object`10991100 Confirmation of a deleted vault.11011102 - `type: "vault_deleted"`11031104 - `id: string`11051106 Unique identifier of the deleted vault.11071108### Beta Managed Agents Vault11091110- `BetaManagedAgentsVault object`11111112 A vault that stores credentials for use by agents during sessions.11131114 - `type: "vault"`11151116 - `id: string`11171118 Unique identifier for the vault.11191120 - `archived_at: string or null`11211122 A timestamp in RFC 3339 format11231124 format: date-time11251126 - `created_at: string`11271128 A timestamp in RFC 3339 format11291130 format: date-time11311132 - `display_name: string`11331134 Human-readable name for the vault.11351136 - `metadata: map[string]`11371138 Arbitrary key-value metadata attached to the vault.11391140 - `updated_at: string`11411142 A timestamp in RFC 3339 format11431144 format: date-time11451146## Vaults › Credentials11471148### Create Credential11491150**POST** `/v1/vaults/{vault_id}/credentials`11511152Create Credential11531154#### Path parameters11551156- `vault_id: string`11571158#### Headers11591160- `"anthropic-beta": optional array of AnthropicBeta`11611162 Optional header to specify the beta version(s) you want to use.11631164 - `string`11651166 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`11671168 - `"message-batches-2024-09-24"`11691170 - `"prompt-caching-2024-07-31"`11711172 - `"computer-use-2024-10-22"`11731174 - `"computer-use-2025-01-24"`11751176 - `"pdfs-2024-09-25"`11771178 - `"token-counting-2024-11-01"`11791180 - `"token-efficient-tools-2025-02-19"`11811182 - `"output-128k-2025-02-19"`11831184 - `"files-api-2025-04-14"`11851186 - `"mcp-client-2025-04-04"`11871188 - `"mcp-client-2025-11-20"`11891190 - `"dev-full-thinking-2025-05-14"`11911192 - `"interleaved-thinking-2025-05-14"`11931194 - `"code-execution-2025-05-22"`11951196 - `"extended-cache-ttl-2025-04-11"`11971198 - `"context-1m-2025-08-07"`11991200 - `"context-management-2025-06-27"`12011202 - `"model-context-window-exceeded-2025-08-26"`12031204 - `"skills-2025-10-02"`12051206 - `"fast-mode-2026-02-01"`12071208 - `"output-300k-2026-03-24"`12091210 - `"user-profiles-2026-03-24"`12111212 - `"user-profiles-2026-08-18"`12131214 - `"user-profiles-2026-09-04"`12151216 - `"advisor-tool-2026-03-01"`12171218 - `"managed-agents-2026-04-01"`12191220 - `"cache-diagnosis-2026-04-07"`12211222 - `"dreaming-2026-04-21"`12231224 - `"thinking-token-count-2026-05-13"`12251226 - `"server-side-fallback-2026-06-01"`12271228 - `"server-side-fallback-2026-07-01"`12291230 - `"fallback-credit-2026-06-01"`12311232 - `"fallback-credit-2026-07-01"`12331234 - `"agent-memory-2026-07-22"`12351236 - `"mid-conversation-tool-changes-2026-07-01"`12371238 - `"compact-2026-01-12"`12391240 - `"computer-use-2025-11-24"`12411242 - `"mcp-tunnels-2026-06-22"`12431244 - `"structured-outputs-2025-11-13"`12451246 - `"task-budgets-2026-03-13"`12471248 - `"thinking-display-updates-2026-08-18"`12491250 - `"ce-user-management-2026-07-13"`12511252 - `"mid-conversation-output-config-2026-07-01"`12531254 - `"thinking-binding-controls-2026-08-01"`12551256 - `"mid-conversation-system-clear-at-2026-08-21"`12571258 - `"compact-2026-09-04"`12591260- `"anthropic-workspace-id": optional string`12611262#### Body parameters12631264- `auth: BetaManagedAgentsMCPOAuthCreateParams or BetaManagedAgentsStaticBearerCreateParams or BetaManagedAgentsEnvironmentVariableCreateParams`12651266 Authentication details for creating a credential.12671268 - `BetaManagedAgentsMCPOAuthCreateParams object`12691270 Parameters for creating an MCP OAuth credential.12711272 - `type: "mcp_oauth"`12731274 - `access_token: string`12751276 OAuth access token.12771278 minLength: 1, maxLength: 819212791280 - `mcp_server_url: string`12811282 URL of the MCP server this credential authenticates against.12831284 minLength: 1, maxLength: 204712851286 - `expires_at: optional string or null`12871288 A timestamp in RFC 3339 format12891290 format: date-time12911292 - `refresh: optional BetaManagedAgentsMCPOAuthRefreshParams or null`12931294 OAuth refresh token parameters for creating a credential with refresh support.12951296 - `client_id: string`12971298 OAuth client ID.12991300 minLength: 1, maxLength: 102413011302 - `refresh_token: string`13031304 OAuth refresh token.13051306 minLength: 1, maxLength: 819213071308 - `token_endpoint: string`13091310 Token endpoint URL used to refresh the access token.13111312 minLength: 1, maxLength: 204713131314 - `token_endpoint_auth: BetaManagedAgentsTokenEndpointAuthNoneParam or BetaManagedAgentsTokenEndpointAuthBasicParam or BetaManagedAgentsTokenEndpointAuthPostParam`13151316 - `BetaManagedAgentsTokenEndpointAuthNoneParam object`13171318 Token endpoint requires no client authentication.13191320 - `type: "none"`13211322 - `BetaManagedAgentsTokenEndpointAuthBasicParam object`13231324 Token endpoint uses HTTP Basic authentication with client credentials.13251326 - `type: "client_secret_basic"`13271328 - `client_secret: string`13291330 OAuth client secret.13311332 minLength: 1, maxLength: 51213331334 - `BetaManagedAgentsTokenEndpointAuthPostParam object`13351336 Token endpoint uses POST body authentication with client credentials.13371338 - `type: "client_secret_post"`13391340 - `client_secret: string`13411342 OAuth client secret.13431344 minLength: 1, maxLength: 51213451346 - `resource: optional string or null`13471348 OAuth resource indicator.13491350 minLength: 1, maxLength: 204713511352 - `scope: optional string or null`13531354 OAuth scope for the refresh request.13551356 minLength: 1, maxLength: 819213571358 - `BetaManagedAgentsStaticBearerCreateParams object`13591360 Parameters for creating a static bearer token credential.13611362 - `type: "static_bearer"`13631364 - `token: string`13651366 Static bearer token value.13671368 minLength: 1, maxLength: 819213691370 - `mcp_server_url: string`13711372 URL of the MCP server this credential authenticates against.13731374 minLength: 1, maxLength: 204713751376 - `BetaManagedAgentsEnvironmentVariableCreateParams object`13771378 Parameters for creating an environment variable credential.13791380 - `type: "environment_variable"`13811382 - `networking: BetaManagedAgentsCredentialNetworkingParams`13831384 Outbound hosts the secret value is substituted on.13851386 - `BetaManagedAgentsUnrestrictedCredentialNetworkingParams object`13871388 Substitute the secret on any host the session's Environment network policy permits egress to. The Environment's network policy is the only boundary on where the secret can reach.13891390 - `type: "unrestricted"`13911392 - `BetaManagedAgentsLimitedCredentialNetworkingParams object`13931394 Substitute the secret only on requests to the listed hosts.13951396 - `type: "limited"`13971398 - `allowed_hosts: array of string`13991400 Hostnames on which the secret will be substituted. Each entry is a bare hostname (`api.example.com`), an IPv4 address (`192.0.2.1`), or a `*.`-prefixed wildcard (`*.example.com`). URLs, ports, paths, and IPv6 addresses are not accepted. At most 16 entries.14011402 - `secret_name: string`14031404 Name of the environment variable. Immutable after create.14051406 minLength: 1, maxLength: 25514071408 - `secret_value: string`14091410 Secret value. Write-only; never returned in responses.14111412 minLength: 1, maxLength: 409614131414 - `injection_location: optional BetaManagedAgentsInjectionLocationParams`14151416 Where in the outbound request the secret value may be substituted.14171418 - `body: optional boolean`14191420 Substitute when the placeholder appears in the request body.14211422 - `header: optional boolean`14231424 Substitute when the placeholder appears in a request header value.14251426- `display_name: optional string or null`14271428 Human-readable name for the credential. Up to 255 characters.14291430 maxLength: 25514311432- `metadata: optional map[string]`14331434 Arbitrary key-value metadata to attach to the credential. Maximum 16 pairs, keys up to 64 chars, values up to 512 chars.14351436#### Returns14371438- `BetaManagedAgentsCredential object`14391440 A credential stored in a vault. Sensitive fields are never returned in responses.14411442 - `type: "vault_credential"`14431444 - `id: string`14451446 Unique identifier for the credential.14471448 - `archived_at: string or null`14491450 A timestamp in RFC 3339 format14511452 format: date-time14531454 - `auth: BetaManagedAgentsMCPOAuthAuthResponse or BetaManagedAgentsStaticBearerAuthResponse or BetaManagedAgentsEnvironmentVariableAuthResponse`14551456 Authentication details for a credential.14571458 - `BetaManagedAgentsMCPOAuthAuthResponse object`14591460 OAuth credential details for an MCP server.14611462 - `type: "mcp_oauth"`14631464 - `mcp_server_url: string`14651466 URL of the MCP server this credential authenticates against.14671468 - `expires_at: optional string or null`14691470 A timestamp in RFC 3339 format14711472 format: date-time14731474 - `refresh: optional BetaManagedAgentsMCPOAuthRefreshResponse or null`14751476 OAuth refresh token configuration returned in credential responses.14771478 - `client_id: string`14791480 OAuth client ID.14811482 - `token_endpoint: string`14831484 Token endpoint URL used to refresh the access token.14851486 - `token_endpoint_auth: BetaManagedAgentsTokenEndpointAuthNoneResponse or BetaManagedAgentsTokenEndpointAuthBasicResponse or BetaManagedAgentsTokenEndpointAuthPostResponse`14871488 - `BetaManagedAgentsTokenEndpointAuthNoneResponse object`14891490 Token endpoint requires no client authentication.14911492 - `type: "none"`14931494 - `BetaManagedAgentsTokenEndpointAuthBasicResponse object`14951496 Token endpoint uses HTTP Basic authentication with client credentials.14971498 - `type: "client_secret_basic"`14991500 - `BetaManagedAgentsTokenEndpointAuthPostResponse object`15011502 Token endpoint uses POST body authentication with client credentials.15031504 - `type: "client_secret_post"`15051506 - `resource: optional string or null`15071508 OAuth resource indicator.15091510 - `scope: optional string or null`15111512 OAuth scope for the refresh request.15131514 - `BetaManagedAgentsStaticBearerAuthResponse object`15151516 Static bearer token credential details for an MCP server.15171518 - `type: "static_bearer"`15191520 - `mcp_server_url: string`15211522 URL of the MCP server this credential authenticates against.15231524 - `BetaManagedAgentsEnvironmentVariableAuthResponse object`15251526 Environment variable credential details. The secret value is never returned.15271528 - `type: "environment_variable"`15291530 - `injection_location: BetaManagedAgentsInjectionLocationResponse`15311532 Where in the outbound request the secret value is substituted.15331534 - `body: boolean`15351536 Whether the placeholder is substituted in the request body.15371538 - `header: boolean`15391540 Whether the placeholder is substituted in request header values.15411542 - `networking: BetaManagedAgentsUnrestrictedCredentialNetworkingResponse or BetaManagedAgentsLimitedCredentialNetworkingResponse`15431544 Outbound hosts the secret value is substituted on.15451546 - `BetaManagedAgentsUnrestrictedCredentialNetworkingResponse object`15471548 The secret is substituted on any host the session's Environment network policy permits egress to.15491550 - `type: "unrestricted"`15511552 - `BetaManagedAgentsLimitedCredentialNetworkingResponse object`15531554 The secret is substituted only on requests to the listed hosts.15551556 - `type: "limited"`15571558 - `allowed_hosts: array of string`15591560 Hostnames on which the secret will be substituted. An entry matches the request host exactly; a `*.`-prefixed entry matches any subdomain of the named domain but not the domain itself.15611562 - `secret_name: string`15631564 Name of the environment variable.15651566 - `created_at: string`15671568 A timestamp in RFC 3339 format15691570 format: date-time15711572 - `metadata: map[string]`15731574 Arbitrary key-value metadata attached to the credential.15751576 - `updated_at: string`15771578 A timestamp in RFC 3339 format15791580 format: date-time15811582 - `vault_id: string`15831584 Identifier of the vault this credential belongs to.15851586 - `display_name: optional string or null`15871588 Human-readable name for the credential.15891590#### Example15911592```bash1593curl https://api.anthropic.com/v1/vaults/$VAULT_ID/credentials \1594 -H 'Content-Type: application/json' \1595 -H 'anthropic-version: 2023-06-01' \1596 -H 'anthropic-beta: managed-agents-2026-04-01' \1597 -H "X-Api-Key: $ANTHROPIC_API_KEY" \1598 -d '{1599 "auth": {1600 "token": "bearer_exampletoken",1601 "mcp_server_url": "https://example-server.modelcontextprotocol.io/sse",1602 "type": "static_bearer"1603 },1604 "display_name": "Example credential",1605 "metadata": {1606 "environment": "production"1607 }1608 }'1609```16101611##### Response (200)16121613```json1614{1615 "id": "vcrd_011CZkZEMt8gZan2iYOQfSkw",1616 "archived_at": null,1617 "auth": {1618 "mcp_server_url": "https://example-server.modelcontextprotocol.io/sse",1619 "type": "static_bearer"1620 },1621 "created_at": "2026-03-15T10:00:00Z",1622 "metadata": {1623 "environment": "production"1624 },1625 "type": "vault_credential",1626 "updated_at": "2026-03-15T10:00:00Z",1627 "vault_id": "vlt_011CZkZDLs7fYzm1hXNPeRjv",1628 "display_name": "Example credential"1629}1630```16311632### List Credentials16331634**GET** `/v1/vaults/{vault_id}/credentials`16351636List Credentials16371638#### Path parameters16391640- `vault_id: string`16411642#### Query parameters16431644- `include_archived: optional boolean`16451646 Whether to include archived credentials in the results.16471648- `limit: optional number`16491650 Maximum number of credentials to return per page. Defaults to 20, maximum 100.16511652 format: int3216531654- `page: optional string`16551656 Opaque pagination token from a previous `list_credentials` response.16571658#### Headers16591660- `"anthropic-beta": optional array of AnthropicBeta`16611662 Optional header to specify the beta version(s) you want to use.16631664 - `string`16651666 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`16671668 - `"message-batches-2024-09-24"`16691670 - `"prompt-caching-2024-07-31"`16711672 - `"computer-use-2024-10-22"`16731674 - `"computer-use-2025-01-24"`16751676 - `"pdfs-2024-09-25"`16771678 - `"token-counting-2024-11-01"`16791680 - `"token-efficient-tools-2025-02-19"`16811682 - `"output-128k-2025-02-19"`16831684 - `"files-api-2025-04-14"`16851686 - `"mcp-client-2025-04-04"`16871688 - `"mcp-client-2025-11-20"`16891690 - `"dev-full-thinking-2025-05-14"`16911692 - `"interleaved-thinking-2025-05-14"`16931694 - `"code-execution-2025-05-22"`16951696 - `"extended-cache-ttl-2025-04-11"`16971698 - `"context-1m-2025-08-07"`16991700 - `"context-management-2025-06-27"`17011702 - `"model-context-window-exceeded-2025-08-26"`17031704 - `"skills-2025-10-02"`17051706 - `"fast-mode-2026-02-01"`17071708 - `"output-300k-2026-03-24"`17091710 - `"user-profiles-2026-03-24"`17111712 - `"user-profiles-2026-08-18"`17131714 - `"user-profiles-2026-09-04"`17151716 - `"advisor-tool-2026-03-01"`17171718 - `"managed-agents-2026-04-01"`17191720 - `"cache-diagnosis-2026-04-07"`17211722 - `"dreaming-2026-04-21"`17231724 - `"thinking-token-count-2026-05-13"`17251726 - `"server-side-fallback-2026-06-01"`17271728 - `"server-side-fallback-2026-07-01"`17291730 - `"fallback-credit-2026-06-01"`17311732 - `"fallback-credit-2026-07-01"`17331734 - `"agent-memory-2026-07-22"`17351736 - `"mid-conversation-tool-changes-2026-07-01"`17371738 - `"compact-2026-01-12"`17391740 - `"computer-use-2025-11-24"`17411742 - `"mcp-tunnels-2026-06-22"`17431744 - `"structured-outputs-2025-11-13"`17451746 - `"task-budgets-2026-03-13"`17471748 - `"thinking-display-updates-2026-08-18"`17491750 - `"ce-user-management-2026-07-13"`17511752 - `"mid-conversation-output-config-2026-07-01"`17531754 - `"thinking-binding-controls-2026-08-01"`17551756 - `"mid-conversation-system-clear-at-2026-08-21"`17571758 - `"compact-2026-09-04"`17591760- `"anthropic-workspace-id": optional string`17611762#### Returns17631764- `data: optional array of BetaManagedAgentsCredential`17651766 List of credentials.17671768 - `type: "vault_credential"`17691770 - `id: string`17711772 Unique identifier for the credential.17731774 - `archived_at: string or null`17751776 A timestamp in RFC 3339 format17771778 format: date-time17791780 - `auth: BetaManagedAgentsMCPOAuthAuthResponse or BetaManagedAgentsStaticBearerAuthResponse or BetaManagedAgentsEnvironmentVariableAuthResponse`17811782 Authentication details for a credential.17831784 - `BetaManagedAgentsMCPOAuthAuthResponse object`17851786 OAuth credential details for an MCP server.17871788 - `type: "mcp_oauth"`17891790 - `mcp_server_url: string`17911792 URL of the MCP server this credential authenticates against.17931794 - `expires_at: optional string or null`17951796 A timestamp in RFC 3339 format17971798 format: date-time17991800 - `refresh: optional BetaManagedAgentsMCPOAuthRefreshResponse or null`18011802 OAuth refresh token configuration returned in credential responses.18031804 - `client_id: string`18051806 OAuth client ID.18071808 - `token_endpoint: string`18091810 Token endpoint URL used to refresh the access token.18111812 - `token_endpoint_auth: BetaManagedAgentsTokenEndpointAuthNoneResponse or BetaManagedAgentsTokenEndpointAuthBasicResponse or BetaManagedAgentsTokenEndpointAuthPostResponse`18131814 - `BetaManagedAgentsTokenEndpointAuthNoneResponse object`18151816 Token endpoint requires no client authentication.18171818 - `type: "none"`18191820 - `BetaManagedAgentsTokenEndpointAuthBasicResponse object`18211822 Token endpoint uses HTTP Basic authentication with client credentials.18231824 - `type: "client_secret_basic"`18251826 - `BetaManagedAgentsTokenEndpointAuthPostResponse object`18271828 Token endpoint uses POST body authentication with client credentials.18291830 - `type: "client_secret_post"`18311832 - `resource: optional string or null`18331834 OAuth resource indicator.18351836 - `scope: optional string or null`18371838 OAuth scope for the refresh request.18391840 - `BetaManagedAgentsStaticBearerAuthResponse object`18411842 Static bearer token credential details for an MCP server.18431844 - `type: "static_bearer"`18451846 - `mcp_server_url: string`18471848 URL of the MCP server this credential authenticates against.18491850 - `BetaManagedAgentsEnvironmentVariableAuthResponse object`18511852 Environment variable credential details. The secret value is never returned.18531854 - `type: "environment_variable"`18551856 - `injection_location: BetaManagedAgentsInjectionLocationResponse`18571858 Where in the outbound request the secret value is substituted.18591860 - `body: boolean`18611862 Whether the placeholder is substituted in the request body.18631864 - `header: boolean`18651866 Whether the placeholder is substituted in request header values.18671868 - `networking: BetaManagedAgentsUnrestrictedCredentialNetworkingResponse or BetaManagedAgentsLimitedCredentialNetworkingResponse`18691870 Outbound hosts the secret value is substituted on.18711872 - `BetaManagedAgentsUnrestrictedCredentialNetworkingResponse object`18731874 The secret is substituted on any host the session's Environment network policy permits egress to.18751876 - `type: "unrestricted"`18771878 - `BetaManagedAgentsLimitedCredentialNetworkingResponse object`18791880 The secret is substituted only on requests to the listed hosts.18811882 - `type: "limited"`18831884 - `allowed_hosts: array of string`18851886 Hostnames on which the secret will be substituted. An entry matches the request host exactly; a `*.`-prefixed entry matches any subdomain of the named domain but not the domain itself.18871888 - `secret_name: string`18891890 Name of the environment variable.18911892 - `created_at: string`18931894 A timestamp in RFC 3339 format18951896 format: date-time18971898 - `metadata: map[string]`18991900 Arbitrary key-value metadata attached to the credential.19011902 - `updated_at: string`19031904 A timestamp in RFC 3339 format19051906 format: date-time19071908 - `vault_id: string`19091910 Identifier of the vault this credential belongs to.19111912 - `display_name: optional string or null`19131914 Human-readable name for the credential.19151916- `next_page: optional string or null`19171918 Pagination token for the next page, or null if no more results.19191920#### Example19211922```bash1923curl https://api.anthropic.com/v1/vaults/$VAULT_ID/credentials \1924 -H 'anthropic-version: 2023-06-01' \1925 -H 'anthropic-beta: managed-agents-2026-04-01' \1926 -H "X-Api-Key: $ANTHROPIC_API_KEY"1927```19281929##### Response (200)19301931```json1932{1933 "data": [1934 {1935 "id": "vcrd_011CZkZEMt8gZan2iYOQfSkw",1936 "archived_at": null,1937 "auth": {1938 "mcp_server_url": "https://example-server.modelcontextprotocol.io/sse",1939 "type": "static_bearer"1940 },1941 "created_at": "2026-03-15T10:00:00Z",1942 "metadata": {1943 "environment": "production"1944 },1945 "type": "vault_credential",1946 "updated_at": "2026-03-15T10:00:00Z",1947 "vault_id": "vlt_011CZkZDLs7fYzm1hXNPeRjv",1948 "display_name": "Example credential"1949 }1950 ],1951 "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo="1952}1953```19541955### Get Credential19561957**GET** `/v1/vaults/{vault_id}/credentials/{credential_id}`19581959Get Credential19601961#### Path parameters19621963- `vault_id: string`19641965- `credential_id: string`19661967#### Headers19681969- `"anthropic-beta": optional array of AnthropicBeta`19701971 Optional header to specify the beta version(s) you want to use.19721973 - `string`19741975 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`19761977 - `"message-batches-2024-09-24"`19781979 - `"prompt-caching-2024-07-31"`19801981 - `"computer-use-2024-10-22"`19821983 - `"computer-use-2025-01-24"`19841985 - `"pdfs-2024-09-25"`19861987 - `"token-counting-2024-11-01"`19881989 - `"token-efficient-tools-2025-02-19"`19901991 - `"output-128k-2025-02-19"`19921993 - `"files-api-2025-04-14"`19941995 - `"mcp-client-2025-04-04"`19961997 - `"mcp-client-2025-11-20"`19981999 - `"dev-full-thinking-2025-05-14"`20002001 - `"interleaved-thinking-2025-05-14"`20022003 - `"code-execution-2025-05-22"`20042005 - `"extended-cache-ttl-2025-04-11"`20062007 - `"context-1m-2025-08-07"`20082009 - `"context-management-2025-06-27"`20102011 - `"model-context-window-exceeded-2025-08-26"`20122013 - `"skills-2025-10-02"`20142015 - `"fast-mode-2026-02-01"`20162017 - `"output-300k-2026-03-24"`20182019 - `"user-profiles-2026-03-24"`20202021 - `"user-profiles-2026-08-18"`20222023 - `"user-profiles-2026-09-04"`20242025 - `"advisor-tool-2026-03-01"`20262027 - `"managed-agents-2026-04-01"`20282029 - `"cache-diagnosis-2026-04-07"`20302031 - `"dreaming-2026-04-21"`20322033 - `"thinking-token-count-2026-05-13"`20342035 - `"server-side-fallback-2026-06-01"`20362037 - `"server-side-fallback-2026-07-01"`20382039 - `"fallback-credit-2026-06-01"`20402041 - `"fallback-credit-2026-07-01"`20422043 - `"agent-memory-2026-07-22"`20442045 - `"mid-conversation-tool-changes-2026-07-01"`20462047 - `"compact-2026-01-12"`20482049 - `"computer-use-2025-11-24"`20502051 - `"mcp-tunnels-2026-06-22"`20522053 - `"structured-outputs-2025-11-13"`20542055 - `"task-budgets-2026-03-13"`20562057 - `"thinking-display-updates-2026-08-18"`20582059 - `"ce-user-management-2026-07-13"`20602061 - `"mid-conversation-output-config-2026-07-01"`20622063 - `"thinking-binding-controls-2026-08-01"`20642065 - `"mid-conversation-system-clear-at-2026-08-21"`20662067 - `"compact-2026-09-04"`20682069- `"anthropic-workspace-id": optional string`20702071#### Returns20722073- `BetaManagedAgentsCredential object`20742075 A credential stored in a vault. Sensitive fields are never returned in responses.20762077 - `type: "vault_credential"`20782079 - `id: string`20802081 Unique identifier for the credential.20822083 - `archived_at: string or null`20842085 A timestamp in RFC 3339 format20862087 format: date-time20882089 - `auth: BetaManagedAgentsMCPOAuthAuthResponse or BetaManagedAgentsStaticBearerAuthResponse or BetaManagedAgentsEnvironmentVariableAuthResponse`20902091 Authentication details for a credential.20922093 - `BetaManagedAgentsMCPOAuthAuthResponse object`20942095 OAuth credential details for an MCP server.20962097 - `type: "mcp_oauth"`20982099 - `mcp_server_url: string`21002101 URL of the MCP server this credential authenticates against.21022103 - `expires_at: optional string or null`21042105 A timestamp in RFC 3339 format21062107 format: date-time21082109 - `refresh: optional BetaManagedAgentsMCPOAuthRefreshResponse or null`21102111 OAuth refresh token configuration returned in credential responses.21122113 - `client_id: string`21142115 OAuth client ID.21162117 - `token_endpoint: string`21182119 Token endpoint URL used to refresh the access token.21202121 - `token_endpoint_auth: BetaManagedAgentsTokenEndpointAuthNoneResponse or BetaManagedAgentsTokenEndpointAuthBasicResponse or BetaManagedAgentsTokenEndpointAuthPostResponse`21222123 - `BetaManagedAgentsTokenEndpointAuthNoneResponse object`21242125 Token endpoint requires no client authentication.21262127 - `type: "none"`21282129 - `BetaManagedAgentsTokenEndpointAuthBasicResponse object`21302131 Token endpoint uses HTTP Basic authentication with client credentials.21322133 - `type: "client_secret_basic"`21342135 - `BetaManagedAgentsTokenEndpointAuthPostResponse object`21362137 Token endpoint uses POST body authentication with client credentials.21382139 - `type: "client_secret_post"`21402141 - `resource: optional string or null`21422143 OAuth resource indicator.21442145 - `scope: optional string or null`21462147 OAuth scope for the refresh request.21482149 - `BetaManagedAgentsStaticBearerAuthResponse object`21502151 Static bearer token credential details for an MCP server.21522153 - `type: "static_bearer"`21542155 - `mcp_server_url: string`21562157 URL of the MCP server this credential authenticates against.21582159 - `BetaManagedAgentsEnvironmentVariableAuthResponse object`21602161 Environment variable credential details. The secret value is never returned.21622163 - `type: "environment_variable"`21642165 - `injection_location: BetaManagedAgentsInjectionLocationResponse`21662167 Where in the outbound request the secret value is substituted.21682169 - `body: boolean`21702171 Whether the placeholder is substituted in the request body.21722173 - `header: boolean`21742175 Whether the placeholder is substituted in request header values.21762177 - `networking: BetaManagedAgentsUnrestrictedCredentialNetworkingResponse or BetaManagedAgentsLimitedCredentialNetworkingResponse`21782179 Outbound hosts the secret value is substituted on.21802181 - `BetaManagedAgentsUnrestrictedCredentialNetworkingResponse object`21822183 The secret is substituted on any host the session's Environment network policy permits egress to.21842185 - `type: "unrestricted"`21862187 - `BetaManagedAgentsLimitedCredentialNetworkingResponse object`21882189 The secret is substituted only on requests to the listed hosts.21902191 - `type: "limited"`21922193 - `allowed_hosts: array of string`21942195 Hostnames on which the secret will be substituted. An entry matches the request host exactly; a `*.`-prefixed entry matches any subdomain of the named domain but not the domain itself.21962197 - `secret_name: string`21982199 Name of the environment variable.22002201 - `created_at: string`22022203 A timestamp in RFC 3339 format22042205 format: date-time22062207 - `metadata: map[string]`22082209 Arbitrary key-value metadata attached to the credential.22102211 - `updated_at: string`22122213 A timestamp in RFC 3339 format22142215 format: date-time22162217 - `vault_id: string`22182219 Identifier of the vault this credential belongs to.22202221 - `display_name: optional string or null`22222223 Human-readable name for the credential.22242225#### Example22262227```bash2228curl https://api.anthropic.com/v1/vaults/$VAULT_ID/credentials/$CREDENTIAL_ID \2229 -H 'anthropic-version: 2023-06-01' \2230 -H 'anthropic-beta: managed-agents-2026-04-01' \2231 -H "X-Api-Key: $ANTHROPIC_API_KEY"2232```22332234##### Response (200)22352236```json2237{2238 "id": "vcrd_011CZkZEMt8gZan2iYOQfSkw",2239 "archived_at": null,2240 "auth": {2241 "mcp_server_url": "https://example-server.modelcontextprotocol.io/sse",2242 "type": "static_bearer"2243 },2244 "created_at": "2026-03-15T10:00:00Z",2245 "metadata": {2246 "environment": "production"2247 },2248 "type": "vault_credential",2249 "updated_at": "2026-03-15T10:00:00Z",2250 "vault_id": "vlt_011CZkZDLs7fYzm1hXNPeRjv",2251 "display_name": "Example credential"2252}2253```22542255### Update Credential22562257**POST** `/v1/vaults/{vault_id}/credentials/{credential_id}`22582259Update Credential22602261#### Path parameters22622263- `vault_id: string`22642265- `credential_id: string`22662267#### Headers22682269- `"anthropic-beta": optional array of AnthropicBeta`22702271 Optional header to specify the beta version(s) you want to use.22722273 - `string`22742275 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`22762277 - `"message-batches-2024-09-24"`22782279 - `"prompt-caching-2024-07-31"`22802281 - `"computer-use-2024-10-22"`22822283 - `"computer-use-2025-01-24"`22842285 - `"pdfs-2024-09-25"`22862287 - `"token-counting-2024-11-01"`22882289 - `"token-efficient-tools-2025-02-19"`22902291 - `"output-128k-2025-02-19"`22922293 - `"files-api-2025-04-14"`22942295 - `"mcp-client-2025-04-04"`22962297 - `"mcp-client-2025-11-20"`22982299 - `"dev-full-thinking-2025-05-14"`23002301 - `"interleaved-thinking-2025-05-14"`23022303 - `"code-execution-2025-05-22"`23042305 - `"extended-cache-ttl-2025-04-11"`23062307 - `"context-1m-2025-08-07"`23082309 - `"context-management-2025-06-27"`23102311 - `"model-context-window-exceeded-2025-08-26"`23122313 - `"skills-2025-10-02"`23142315 - `"fast-mode-2026-02-01"`23162317 - `"output-300k-2026-03-24"`23182319 - `"user-profiles-2026-03-24"`23202321 - `"user-profiles-2026-08-18"`23222323 - `"user-profiles-2026-09-04"`23242325 - `"advisor-tool-2026-03-01"`23262327 - `"managed-agents-2026-04-01"`23282329 - `"cache-diagnosis-2026-04-07"`23302331 - `"dreaming-2026-04-21"`23322333 - `"thinking-token-count-2026-05-13"`23342335 - `"server-side-fallback-2026-06-01"`23362337 - `"server-side-fallback-2026-07-01"`23382339 - `"fallback-credit-2026-06-01"`23402341 - `"fallback-credit-2026-07-01"`23422343 - `"agent-memory-2026-07-22"`23442345 - `"mid-conversation-tool-changes-2026-07-01"`23462347 - `"compact-2026-01-12"`23482349 - `"computer-use-2025-11-24"`23502351 - `"mcp-tunnels-2026-06-22"`23522353 - `"structured-outputs-2025-11-13"`23542355 - `"task-budgets-2026-03-13"`23562357 - `"thinking-display-updates-2026-08-18"`23582359 - `"ce-user-management-2026-07-13"`23602361 - `"mid-conversation-output-config-2026-07-01"`23622363 - `"thinking-binding-controls-2026-08-01"`23642365 - `"mid-conversation-system-clear-at-2026-08-21"`23662367 - `"compact-2026-09-04"`23682369- `"anthropic-workspace-id": optional string`23702371#### Body parameters23722373- `auth: optional BetaManagedAgentsMCPOAuthUpdateParams or BetaManagedAgentsStaticBearerUpdateParams or BetaManagedAgentsEnvironmentVariableUpdateParams`23742375 Updated authentication details for a credential.23762377 - `BetaManagedAgentsMCPOAuthUpdateParams object`23782379 Parameters for updating an MCP OAuth credential. The `mcp_server_url` is immutable.23802381 - `type: "mcp_oauth"`23822383 - `access_token: optional string or null`23842385 Updated OAuth access token.23862387 minLength: 1, maxLength: 819223882389 - `expires_at: optional string or null`23902391 A timestamp in RFC 3339 format23922393 format: date-time23942395 - `refresh: optional BetaManagedAgentsMCPOAuthRefreshUpdateParams or null`23962397 Parameters for updating OAuth refresh token configuration.23982399 - `refresh_token: optional string or null`24002401 Updated OAuth refresh token.24022403 minLength: 1, maxLength: 819224042405 - `scope: optional string or null`24062407 Updated OAuth scope for the refresh request.24082409 maxLength: 819224102411 - `token_endpoint_auth: optional BetaManagedAgentsTokenEndpointAuthBasicUpdateParam or BetaManagedAgentsTokenEndpointAuthPostUpdateParam`24122413 - `BetaManagedAgentsTokenEndpointAuthBasicUpdateParam object`24142415 Updated HTTP Basic authentication parameters for the token endpoint.24162417 - `type: "client_secret_basic"`24182419 - `client_secret: optional string or null`24202421 Updated OAuth client secret.24222423 minLength: 1, maxLength: 51224242425 - `BetaManagedAgentsTokenEndpointAuthPostUpdateParam object`24262427 Updated POST body authentication parameters for the token endpoint.24282429 - `type: "client_secret_post"`24302431 - `client_secret: optional string or null`24322433 Updated OAuth client secret.24342435 minLength: 1, maxLength: 51224362437 - `BetaManagedAgentsStaticBearerUpdateParams object`24382439 Parameters for updating a static bearer token credential. The `mcp_server_url` is immutable.24402441 - `type: "static_bearer"`24422443 - `token: optional string or null`24442445 Updated static bearer token value.24462447 minLength: 1, maxLength: 819224482449 - `BetaManagedAgentsEnvironmentVariableUpdateParams object`24502451 Parameters for updating an environment variable credential. `secret_name` is immutable.24522453 - `type: "environment_variable"`24542455 - `injection_location: optional BetaManagedAgentsInjectionLocationUpdateParams`24562457 Updated injection location.24582459 - `body: optional boolean`24602461 Substitute when the placeholder appears in the request body.24622463 - `header: optional boolean`24642465 Substitute when the placeholder appears in a request header value.24662467 - `networking: optional BetaManagedAgentsCredentialNetworkingParams or null`24682469 Updated networking scope. Full replacement.24702471 - `BetaManagedAgentsUnrestrictedCredentialNetworkingParams object`24722473 Substitute the secret on any host the session's Environment network policy permits egress to. The Environment's network policy is the only boundary on where the secret can reach.24742475 - `type: "unrestricted"`24762477 - `BetaManagedAgentsLimitedCredentialNetworkingParams object`24782479 Substitute the secret only on requests to the listed hosts.24802481 - `type: "limited"`24822483 - `allowed_hosts: array of string`24842485 Hostnames on which the secret will be substituted. Each entry is a bare hostname (`api.example.com`), an IPv4 address (`192.0.2.1`), or a `*.`-prefixed wildcard (`*.example.com`). URLs, ports, paths, and IPv6 addresses are not accepted. At most 16 entries.24862487 - `secret_value: optional string or null`24882489 Updated secret value.24902491 minLength: 1, maxLength: 409624922493- `display_name: optional string or null`24942495 Updated human-readable name for the credential. 1-255 characters.24962497 minLength: 1, maxLength: 25524982499- `metadata: optional map[string] or null`25002501 Metadata patch. Set a key to a string to upsert it, or to null to delete it. Omitted keys are preserved.25022503#### Returns25042505- `BetaManagedAgentsCredential object`25062507 A credential stored in a vault. Sensitive fields are never returned in responses.25082509 - `type: "vault_credential"`25102511 - `id: string`25122513 Unique identifier for the credential.25142515 - `archived_at: string or null`25162517 A timestamp in RFC 3339 format25182519 format: date-time25202521 - `auth: BetaManagedAgentsMCPOAuthAuthResponse or BetaManagedAgentsStaticBearerAuthResponse or BetaManagedAgentsEnvironmentVariableAuthResponse`25222523 Authentication details for a credential.25242525 - `BetaManagedAgentsMCPOAuthAuthResponse object`25262527 OAuth credential details for an MCP server.25282529 - `type: "mcp_oauth"`25302531 - `mcp_server_url: string`25322533 URL of the MCP server this credential authenticates against.25342535 - `expires_at: optional string or null`25362537 A timestamp in RFC 3339 format25382539 format: date-time25402541 - `refresh: optional BetaManagedAgentsMCPOAuthRefreshResponse or null`25422543 OAuth refresh token configuration returned in credential responses.25442545 - `client_id: string`25462547 OAuth client ID.25482549 - `token_endpoint: string`25502551 Token endpoint URL used to refresh the access token.25522553 - `token_endpoint_auth: BetaManagedAgentsTokenEndpointAuthNoneResponse or BetaManagedAgentsTokenEndpointAuthBasicResponse or BetaManagedAgentsTokenEndpointAuthPostResponse`25542555 - `BetaManagedAgentsTokenEndpointAuthNoneResponse object`25562557 Token endpoint requires no client authentication.25582559 - `type: "none"`25602561 - `BetaManagedAgentsTokenEndpointAuthBasicResponse object`25622563 Token endpoint uses HTTP Basic authentication with client credentials.25642565 - `type: "client_secret_basic"`25662567 - `BetaManagedAgentsTokenEndpointAuthPostResponse object`25682569 Token endpoint uses POST body authentication with client credentials.25702571 - `type: "client_secret_post"`25722573 - `resource: optional string or null`25742575 OAuth resource indicator.25762577 - `scope: optional string or null`25782579 OAuth scope for the refresh request.25802581 - `BetaManagedAgentsStaticBearerAuthResponse object`25822583 Static bearer token credential details for an MCP server.25842585 - `type: "static_bearer"`25862587 - `mcp_server_url: string`25882589 URL of the MCP server this credential authenticates against.25902591 - `BetaManagedAgentsEnvironmentVariableAuthResponse object`25922593 Environment variable credential details. The secret value is never returned.25942595 - `type: "environment_variable"`25962597 - `injection_location: BetaManagedAgentsInjectionLocationResponse`25982599 Where in the outbound request the secret value is substituted.26002601 - `body: boolean`26022603 Whether the placeholder is substituted in the request body.26042605 - `header: boolean`26062607 Whether the placeholder is substituted in request header values.26082609 - `networking: BetaManagedAgentsUnrestrictedCredentialNetworkingResponse or BetaManagedAgentsLimitedCredentialNetworkingResponse`26102611 Outbound hosts the secret value is substituted on.26122613 - `BetaManagedAgentsUnrestrictedCredentialNetworkingResponse object`26142615 The secret is substituted on any host the session's Environment network policy permits egress to.26162617 - `type: "unrestricted"`26182619 - `BetaManagedAgentsLimitedCredentialNetworkingResponse object`26202621 The secret is substituted only on requests to the listed hosts.26222623 - `type: "limited"`26242625 - `allowed_hosts: array of string`26262627 Hostnames on which the secret will be substituted. An entry matches the request host exactly; a `*.`-prefixed entry matches any subdomain of the named domain but not the domain itself.26282629 - `secret_name: string`26302631 Name of the environment variable.26322633 - `created_at: string`26342635 A timestamp in RFC 3339 format26362637 format: date-time26382639 - `metadata: map[string]`26402641 Arbitrary key-value metadata attached to the credential.26422643 - `updated_at: string`26442645 A timestamp in RFC 3339 format26462647 format: date-time26482649 - `vault_id: string`26502651 Identifier of the vault this credential belongs to.26522653 - `display_name: optional string or null`26542655 Human-readable name for the credential.26562657#### Example26582659```bash2660curl https://api.anthropic.com/v1/vaults/$VAULT_ID/credentials/$CREDENTIAL_ID \2661 -H 'Content-Type: application/json' \2662 -H 'anthropic-version: 2023-06-01' \2663 -H 'anthropic-beta: managed-agents-2026-04-01' \2664 -H "X-Api-Key: $ANTHROPIC_API_KEY" \2665 -d '{2666 "display_name": "Example credential",2667 "metadata": {2668 "environment": "production"2669 }2670 }'2671```26722673##### Response (200)26742675```json2676{2677 "id": "vcrd_011CZkZEMt8gZan2iYOQfSkw",2678 "archived_at": null,2679 "auth": {2680 "mcp_server_url": "https://example-server.modelcontextprotocol.io/sse",2681 "type": "static_bearer"2682 },2683 "created_at": "2026-03-15T10:00:00Z",2684 "metadata": {2685 "environment": "production"2686 },2687 "type": "vault_credential",2688 "updated_at": "2026-03-15T10:00:00Z",2689 "vault_id": "vlt_011CZkZDLs7fYzm1hXNPeRjv",2690 "display_name": "Example credential"2691}2692```26932694### Delete Credential26952696**DELETE** `/v1/vaults/{vault_id}/credentials/{credential_id}`26972698Delete Credential26992700#### Path parameters27012702- `vault_id: string`27032704- `credential_id: string`27052706#### Headers27072708- `"anthropic-beta": optional array of AnthropicBeta`27092710 Optional header to specify the beta version(s) you want to use.27112712 - `string`27132714 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`27152716 - `"message-batches-2024-09-24"`27172718 - `"prompt-caching-2024-07-31"`27192720 - `"computer-use-2024-10-22"`27212722 - `"computer-use-2025-01-24"`27232724 - `"pdfs-2024-09-25"`27252726 - `"token-counting-2024-11-01"`27272728 - `"token-efficient-tools-2025-02-19"`27292730 - `"output-128k-2025-02-19"`27312732 - `"files-api-2025-04-14"`27332734 - `"mcp-client-2025-04-04"`27352736 - `"mcp-client-2025-11-20"`27372738 - `"dev-full-thinking-2025-05-14"`27392740 - `"interleaved-thinking-2025-05-14"`27412742 - `"code-execution-2025-05-22"`27432744 - `"extended-cache-ttl-2025-04-11"`27452746 - `"context-1m-2025-08-07"`27472748 - `"context-management-2025-06-27"`27492750 - `"model-context-window-exceeded-2025-08-26"`27512752 - `"skills-2025-10-02"`27532754 - `"fast-mode-2026-02-01"`27552756 - `"output-300k-2026-03-24"`27572758 - `"user-profiles-2026-03-24"`27592760 - `"user-profiles-2026-08-18"`27612762 - `"user-profiles-2026-09-04"`27632764 - `"advisor-tool-2026-03-01"`27652766 - `"managed-agents-2026-04-01"`27672768 - `"cache-diagnosis-2026-04-07"`27692770 - `"dreaming-2026-04-21"`27712772 - `"thinking-token-count-2026-05-13"`27732774 - `"server-side-fallback-2026-06-01"`27752776 - `"server-side-fallback-2026-07-01"`27772778 - `"fallback-credit-2026-06-01"`27792780 - `"fallback-credit-2026-07-01"`27812782 - `"agent-memory-2026-07-22"`27832784 - `"mid-conversation-tool-changes-2026-07-01"`27852786 - `"compact-2026-01-12"`27872788 - `"computer-use-2025-11-24"`27892790 - `"mcp-tunnels-2026-06-22"`27912792 - `"structured-outputs-2025-11-13"`27932794 - `"task-budgets-2026-03-13"`27952796 - `"thinking-display-updates-2026-08-18"`27972798 - `"ce-user-management-2026-07-13"`27992800 - `"mid-conversation-output-config-2026-07-01"`28012802 - `"thinking-binding-controls-2026-08-01"`28032804 - `"mid-conversation-system-clear-at-2026-08-21"`28052806 - `"compact-2026-09-04"`28072808- `"anthropic-workspace-id": optional string`28092810#### Returns28112812- `BetaManagedAgentsDeletedCredential object`28132814 Confirmation of a deleted credential.28152816 - `type: "vault_credential_deleted"`28172818 - `id: string`28192820 Unique identifier of the deleted credential.28212822#### Example28232824```bash2825curl https://api.anthropic.com/v1/vaults/$VAULT_ID/credentials/$CREDENTIAL_ID \2826 -X DELETE \2827 -H 'anthropic-version: 2023-06-01' \2828 -H 'anthropic-beta: managed-agents-2026-04-01' \2829 -H "X-Api-Key: $ANTHROPIC_API_KEY"2830```28312832##### Response (200)28332834```json2835{2836 "id": "vcrd_011CZkZEMt8gZan2iYOQfSkw",2837 "type": "vault_credential_deleted"2838}2839```28402841### Archive Credential28422843**POST** `/v1/vaults/{vault_id}/credentials/{credential_id}/archive`28442845Archive Credential28462847#### Path parameters28482849- `vault_id: string`28502851- `credential_id: string`28522853#### Headers28542855- `"anthropic-beta": optional array of AnthropicBeta`28562857 Optional header to specify the beta version(s) you want to use.28582859 - `string`28602861 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`28622863 - `"message-batches-2024-09-24"`28642865 - `"prompt-caching-2024-07-31"`28662867 - `"computer-use-2024-10-22"`28682869 - `"computer-use-2025-01-24"`28702871 - `"pdfs-2024-09-25"`28722873 - `"token-counting-2024-11-01"`28742875 - `"token-efficient-tools-2025-02-19"`28762877 - `"output-128k-2025-02-19"`28782879 - `"files-api-2025-04-14"`28802881 - `"mcp-client-2025-04-04"`28822883 - `"mcp-client-2025-11-20"`28842885 - `"dev-full-thinking-2025-05-14"`28862887 - `"interleaved-thinking-2025-05-14"`28882889 - `"code-execution-2025-05-22"`28902891 - `"extended-cache-ttl-2025-04-11"`28922893 - `"context-1m-2025-08-07"`28942895 - `"context-management-2025-06-27"`28962897 - `"model-context-window-exceeded-2025-08-26"`28982899 - `"skills-2025-10-02"`29002901 - `"fast-mode-2026-02-01"`29022903 - `"output-300k-2026-03-24"`29042905 - `"user-profiles-2026-03-24"`29062907 - `"user-profiles-2026-08-18"`29082909 - `"user-profiles-2026-09-04"`29102911 - `"advisor-tool-2026-03-01"`29122913 - `"managed-agents-2026-04-01"`29142915 - `"cache-diagnosis-2026-04-07"`29162917 - `"dreaming-2026-04-21"`29182919 - `"thinking-token-count-2026-05-13"`29202921 - `"server-side-fallback-2026-06-01"`29222923 - `"server-side-fallback-2026-07-01"`29242925 - `"fallback-credit-2026-06-01"`29262927 - `"fallback-credit-2026-07-01"`29282929 - `"agent-memory-2026-07-22"`29302931 - `"mid-conversation-tool-changes-2026-07-01"`29322933 - `"compact-2026-01-12"`29342935 - `"computer-use-2025-11-24"`29362937 - `"mcp-tunnels-2026-06-22"`29382939 - `"structured-outputs-2025-11-13"`29402941 - `"task-budgets-2026-03-13"`29422943 - `"thinking-display-updates-2026-08-18"`29442945 - `"ce-user-management-2026-07-13"`29462947 - `"mid-conversation-output-config-2026-07-01"`29482949 - `"thinking-binding-controls-2026-08-01"`29502951 - `"mid-conversation-system-clear-at-2026-08-21"`29522953 - `"compact-2026-09-04"`29542955- `"anthropic-workspace-id": optional string`29562957#### Returns29582959- `BetaManagedAgentsCredential object`29602961 A credential stored in a vault. Sensitive fields are never returned in responses.29622963 - `type: "vault_credential"`29642965 - `id: string`29662967 Unique identifier for the credential.29682969 - `archived_at: string or null`29702971 A timestamp in RFC 3339 format29722973 format: date-time29742975 - `auth: BetaManagedAgentsMCPOAuthAuthResponse or BetaManagedAgentsStaticBearerAuthResponse or BetaManagedAgentsEnvironmentVariableAuthResponse`29762977 Authentication details for a credential.29782979 - `BetaManagedAgentsMCPOAuthAuthResponse object`29802981 OAuth credential details for an MCP server.29822983 - `type: "mcp_oauth"`29842985 - `mcp_server_url: string`29862987 URL of the MCP server this credential authenticates against.29882989 - `expires_at: optional string or null`29902991 A timestamp in RFC 3339 format29922993 format: date-time29942995 - `refresh: optional BetaManagedAgentsMCPOAuthRefreshResponse or null`29962997 OAuth refresh token configuration returned in credential responses.29982999 - `client_id: string`30003001 OAuth client ID.30023003 - `token_endpoint: string`30043005 Token endpoint URL used to refresh the access token.30063007 - `token_endpoint_auth: BetaManagedAgentsTokenEndpointAuthNoneResponse or BetaManagedAgentsTokenEndpointAuthBasicResponse or BetaManagedAgentsTokenEndpointAuthPostResponse`30083009 - `BetaManagedAgentsTokenEndpointAuthNoneResponse object`30103011 Token endpoint requires no client authentication.30123013 - `type: "none"`30143015 - `BetaManagedAgentsTokenEndpointAuthBasicResponse object`30163017 Token endpoint uses HTTP Basic authentication with client credentials.30183019 - `type: "client_secret_basic"`30203021 - `BetaManagedAgentsTokenEndpointAuthPostResponse object`30223023 Token endpoint uses POST body authentication with client credentials.30243025 - `type: "client_secret_post"`30263027 - `resource: optional string or null`30283029 OAuth resource indicator.30303031 - `scope: optional string or null`30323033 OAuth scope for the refresh request.30343035 - `BetaManagedAgentsStaticBearerAuthResponse object`30363037 Static bearer token credential details for an MCP server.30383039 - `type: "static_bearer"`30403041 - `mcp_server_url: string`30423043 URL of the MCP server this credential authenticates against.30443045 - `BetaManagedAgentsEnvironmentVariableAuthResponse object`30463047 Environment variable credential details. The secret value is never returned.30483049 - `type: "environment_variable"`30503051 - `injection_location: BetaManagedAgentsInjectionLocationResponse`30523053 Where in the outbound request the secret value is substituted.30543055 - `body: boolean`30563057 Whether the placeholder is substituted in the request body.30583059 - `header: boolean`30603061 Whether the placeholder is substituted in request header values.30623063 - `networking: BetaManagedAgentsUnrestrictedCredentialNetworkingResponse or BetaManagedAgentsLimitedCredentialNetworkingResponse`30643065 Outbound hosts the secret value is substituted on.30663067 - `BetaManagedAgentsUnrestrictedCredentialNetworkingResponse object`30683069 The secret is substituted on any host the session's Environment network policy permits egress to.30703071 - `type: "unrestricted"`30723073 - `BetaManagedAgentsLimitedCredentialNetworkingResponse object`30743075 The secret is substituted only on requests to the listed hosts.30763077 - `type: "limited"`30783079 - `allowed_hosts: array of string`30803081 Hostnames on which the secret will be substituted. An entry matches the request host exactly; a `*.`-prefixed entry matches any subdomain of the named domain but not the domain itself.30823083 - `secret_name: string`30843085 Name of the environment variable.30863087 - `created_at: string`30883089 A timestamp in RFC 3339 format30903091 format: date-time30923093 - `metadata: map[string]`30943095 Arbitrary key-value metadata attached to the credential.30963097 - `updated_at: string`30983099 A timestamp in RFC 3339 format31003101 format: date-time31023103 - `vault_id: string`31043105 Identifier of the vault this credential belongs to.31063107 - `display_name: optional string or null`31083109 Human-readable name for the credential.31103111#### Example31123113```bash3114curl https://api.anthropic.com/v1/vaults/$VAULT_ID/credentials/$CREDENTIAL_ID/archive \3115 -X POST \3116 -H 'anthropic-version: 2023-06-01' \3117 -H 'anthropic-beta: managed-agents-2026-04-01' \3118 -H "X-Api-Key: $ANTHROPIC_API_KEY"3119```31203121##### Response (200)31223123```json3124{3125 "id": "vcrd_011CZkZEMt8gZan2iYOQfSkw",3126 "archived_at": null,3127 "auth": {3128 "mcp_server_url": "https://example-server.modelcontextprotocol.io/sse",3129 "type": "static_bearer"3130 },3131 "created_at": "2026-03-15T10:00:00Z",3132 "metadata": {3133 "environment": "production"3134 },3135 "type": "vault_credential",3136 "updated_at": "2026-03-15T10:00:00Z",3137 "vault_id": "vlt_011CZkZDLs7fYzm1hXNPeRjv",3138 "display_name": "Example credential"3139}3140```31413142### Validate Credential31433144**POST** `/v1/vaults/{vault_id}/credentials/{credential_id}/mcp_oauth_validate`31453146Validate Credential31473148#### Path parameters31493150- `vault_id: string`31513152- `credential_id: string`31533154#### Headers31553156- `"anthropic-beta": optional array of AnthropicBeta`31573158 Optional header to specify the beta version(s) you want to use.31593160 - `string`31613162 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`31633164 - `"message-batches-2024-09-24"`31653166 - `"prompt-caching-2024-07-31"`31673168 - `"computer-use-2024-10-22"`31693170 - `"computer-use-2025-01-24"`31713172 - `"pdfs-2024-09-25"`31733174 - `"token-counting-2024-11-01"`31753176 - `"token-efficient-tools-2025-02-19"`31773178 - `"output-128k-2025-02-19"`31793180 - `"files-api-2025-04-14"`31813182 - `"mcp-client-2025-04-04"`31833184 - `"mcp-client-2025-11-20"`31853186 - `"dev-full-thinking-2025-05-14"`31873188 - `"interleaved-thinking-2025-05-14"`31893190 - `"code-execution-2025-05-22"`31913192 - `"extended-cache-ttl-2025-04-11"`31933194 - `"context-1m-2025-08-07"`31953196 - `"context-management-2025-06-27"`31973198 - `"model-context-window-exceeded-2025-08-26"`31993200 - `"skills-2025-10-02"`32013202 - `"fast-mode-2026-02-01"`32033204 - `"output-300k-2026-03-24"`32053206 - `"user-profiles-2026-03-24"`32073208 - `"user-profiles-2026-08-18"`32093210 - `"user-profiles-2026-09-04"`32113212 - `"advisor-tool-2026-03-01"`32133214 - `"managed-agents-2026-04-01"`32153216 - `"cache-diagnosis-2026-04-07"`32173218 - `"dreaming-2026-04-21"`32193220 - `"thinking-token-count-2026-05-13"`32213222 - `"server-side-fallback-2026-06-01"`32233224 - `"server-side-fallback-2026-07-01"`32253226 - `"fallback-credit-2026-06-01"`32273228 - `"fallback-credit-2026-07-01"`32293230 - `"agent-memory-2026-07-22"`32313232 - `"mid-conversation-tool-changes-2026-07-01"`32333234 - `"compact-2026-01-12"`32353236 - `"computer-use-2025-11-24"`32373238 - `"mcp-tunnels-2026-06-22"`32393240 - `"structured-outputs-2025-11-13"`32413242 - `"task-budgets-2026-03-13"`32433244 - `"thinking-display-updates-2026-08-18"`32453246 - `"ce-user-management-2026-07-13"`32473248 - `"mid-conversation-output-config-2026-07-01"`32493250 - `"thinking-binding-controls-2026-08-01"`32513252 - `"mid-conversation-system-clear-at-2026-08-21"`32533254 - `"compact-2026-09-04"`32553256- `"anthropic-workspace-id": optional string`32573258#### Returns32593260- `BetaManagedAgentsCredentialValidation object`32613262 Result of live-probing a credential against its configured MCP server.32633264 - `type: "vault_credential_validation"`32653266 - `credential_id: string`32673268 Unique identifier of the credential that was validated.32693270 - `has_refresh_token: boolean`32713272 Whether the credential has a refresh token configured.32733274 - `mcp_probe: BetaManagedAgentsMCPProbe or null`32753276 The failing step of an MCP validation probe.32773278 - `http_response: BetaManagedAgentsRefreshHTTPResponse or null`32793280 An HTTP response captured during a credential validation probe.32813282 - `body: string`32833284 Response body. May be truncated and has sensitive values scrubbed.32853286 - `body_truncated: boolean`32873288 Whether `body` was truncated.32893290 - `content_type: string`32913292 Value of the `Content-Type` response header.32933294 - `status_code: number`32953296 HTTP status code.32973298 format: int3232993300 - `method: string`33013302 The MCP method that failed (for example `initialize` or `tools/list`).33033304 - `refresh: BetaManagedAgentsRefreshObject or null`33053306 Outcome of a refresh-token exchange attempted during credential validation.33073308 - `http_response: BetaManagedAgentsRefreshHTTPResponse or null`33093310 An HTTP response captured during a credential validation probe.33113312 - `status: "succeeded" or "failed" or "connect_error" or "no_refresh_token"`33133314 Outcome of a refresh-token exchange attempted during credential validation.33153316 - `"succeeded"`33173318 - `"failed"`33193320 - `"connect_error"`33213322 - `"no_refresh_token"`33233324 - `status: BetaManagedAgentsCredentialValidationStatus`33253326 Overall verdict of a credential validation probe.33273328 - `"valid"`33293330 - `"invalid"`33313332 - `"unknown"`33333334 - `validated_at: string`33353336 A timestamp in RFC 3339 format33373338 format: date-time33393340 - `vault_id: string`33413342 Identifier of the vault containing the credential.33433344#### Example33453346```bash3347curl https://api.anthropic.com/v1/vaults/$VAULT_ID/credentials/$CREDENTIAL_ID/mcp_oauth_validate \3348 -X POST \3349 -H 'anthropic-version: 2023-06-01' \3350 -H 'anthropic-beta: managed-agents-2026-04-01' \3351 -H "X-Api-Key: $ANTHROPIC_API_KEY"3352```33533354##### Response (200)33553356```json3357{3358 "credential_id": "vcrd_011CZkZEMt8gZan2iYOQfSkw",3359 "has_refresh_token": true,3360 "mcp_probe": {3361 "http_response": {3362 "body": "body",3363 "body_truncated": true,3364 "content_type": "content_type",3365 "status_code": 03366 },3367 "method": "method"3368 },3369 "refresh": {3370 "http_response": {3371 "body": "body",3372 "body_truncated": true,3373 "content_type": "content_type",3374 "status_code": 03375 },3376 "status": "succeeded"3377 },3378 "status": "valid",3379 "type": "vault_credential_validation",3380 "validated_at": "2026-03-15T10:00:00Z",3381 "vault_id": "vlt_011CZkZDLs7fYzm1hXNPeRjv"3382}3383```3384