The whole hunk
from line 1, old and new numbered
/
lines
from line 1
1---
2title: Vaults
3url: https://platform.claude.com/docs/en/api/beta/vaults
4---
5
16# Vaults
27
38## Create Vault
from line 19
1419
1520 - `string`
1621
17 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
22 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
1823
1924 - `"message-batches-2024-09-24"`
2025
from line 67
6267
6368 - `"user-profiles-2026-08-18"`
6469
70 - `"user-profiles-2026-09-04"`
71
6572 - `"advisor-tool-2026-03-01"`
6673
6774 - `"managed-agents-2026-04-01"`
from line 111
104111
105112 - `"mid-conversation-system-clear-at-2026-08-21"`
106113
114- `"anthropic-workspace-id": optional string`
115
107116### Body parameters
108117
109118- `display_name: string`
from line 131
122131
123132 A vault that stores credentials for use by agents during sessions.
124133
134 - `type: "vault"`
135
125136 - `id: string`
126137
127138 Unique identifier for the vault.
from line 157
146157
147158 Arbitrary key-value metadata attached to the vault.
148159
149 - `type: "vault"`
150
151160 - `updated_at: string`
152161
153162 A timestamp in RFC 3339 format
from line 225
216225
217226 - `string`
218227
219 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
228 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
220229
221230 - `"message-batches-2024-09-24"`
222231
from line 273
264273
265274 - `"user-profiles-2026-08-18"`
266275
276 - `"user-profiles-2026-09-04"`
277
267278 - `"advisor-tool-2026-03-01"`
268279
269280 - `"managed-agents-2026-04-01"`
from line 317
306317
307318 - `"mid-conversation-system-clear-at-2026-08-21"`
308319
320- `"anthropic-workspace-id": optional string`
321
309322### Returns
310323
311324- `data: optional array of BetaManagedAgentsVault`
from line 325
312325
313326 List of vaults.
314327
328 - `type: "vault"`
329
315330 - `id: string`
316331
317332 Unique identifier for the vault.
from line 351
336351
337352 Arbitrary key-value metadata attached to the vault.
338353
339 - `type: "vault"`
340
341354 - `updated_at: string`
342355
343356 A timestamp in RFC 3339 format
from line 409
396409
397410 - `string`
398411
399 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
412 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
400413
401414 - `"message-batches-2024-09-24"`
402415
from line 457
444457
445458 - `"user-profiles-2026-08-18"`
446459
460 - `"user-profiles-2026-09-04"`
461
447462 - `"advisor-tool-2026-03-01"`
448463
449464 - `"managed-agents-2026-04-01"`
from line 501
486501
487502 - `"mid-conversation-system-clear-at-2026-08-21"`
488503
504- `"anthropic-workspace-id": optional string`
505
489506### Returns
490507
491508- `BetaManagedAgentsVault object`
from line 509
492509
493510 A vault that stores credentials for use by agents during sessions.
494511
512 - `type: "vault"`
513
495514 - `id: string`
496515
497516 Unique identifier for the vault.
from line 535
516535
517536 Arbitrary key-value metadata attached to the vault.
518537
519 - `type: "vault"`
520
521538 - `updated_at: string`
522539
523540 A timestamp in RFC 3339 format
from line 584
567584
568585 - `string`
569586
570 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
587 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
571588
572589 - `"message-batches-2024-09-24"`
573590
from line 632
615632
616633 - `"user-profiles-2026-08-18"`
617634
635 - `"user-profiles-2026-09-04"`
636
618637 - `"advisor-tool-2026-03-01"`
619638
620639 - `"managed-agents-2026-04-01"`
from line 676
657676
658677 - `"mid-conversation-system-clear-at-2026-08-21"`
659678
679- `"anthropic-workspace-id": optional string`
680
660681### Body parameters
661682
662683- `display_name: optional string or null`
from line 696
675696
676697 A vault that stores credentials for use by agents during sessions.
677698
699 - `type: "vault"`
700
678701 - `id: string`
679702
680703 Unique identifier for the vault.
from line 722
699722
700723 Arbitrary key-value metadata attached to the vault.
701724
702 - `type: "vault"`
703
704725 - `updated_at: string`
705726
706727 A timestamp in RFC 3339 format
from line 778
757778
758779 - `string`
759780
760 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
781 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
761782
762783 - `"message-batches-2024-09-24"`
763784
from line 826
805826
806827 - `"user-profiles-2026-08-18"`
807828
829 - `"user-profiles-2026-09-04"`
830
808831 - `"advisor-tool-2026-03-01"`
809832
810833 - `"managed-agents-2026-04-01"`
from line 870
847870
848871 - `"mid-conversation-system-clear-at-2026-08-21"`
849872
873- `"anthropic-workspace-id": optional string`
874
850875### Returns
851876
852877- `BetaManagedAgentsDeletedVault object`
from line 878
853878
854879 Confirmation of a deleted vault.
855880
881 - `type: "vault_deleted"`
882
856883 - `id: string`
857884
858885 Unique identifier of the deleted vault.
859886
860 - `type: "vault_deleted"`
861
862887### Example
863888
864889```bash
from line 921
896921
897922 - `string`
898923
899 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
924 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
900925
901926 - `"message-batches-2024-09-24"`
902927
from line 969
944969
945970 - `"user-profiles-2026-08-18"`
946971
972 - `"user-profiles-2026-09-04"`
973
947974 - `"advisor-tool-2026-03-01"`
948975
949976 - `"managed-agents-2026-04-01"`
from line 1013
9861013
9871014 - `"mid-conversation-system-clear-at-2026-08-21"`
9881015
1016- `"anthropic-workspace-id": optional string`
1017
9891018### Returns
9901019
9911020- `BetaManagedAgentsVault object`
from line 1021
9921021
9931022 A vault that stores credentials for use by agents during sessions.
9941023
1024 - `type: "vault"`
1025
9951026 - `id: string`
9961027
9971028 Unique identifier for the vault.
from line 1047
10161047
10171048 Arbitrary key-value metadata attached to the vault.
10181049
1019 - `type: "vault"`
1020
10211050 - `updated_at: string`
10221051
10231052 A timestamp in RFC 3339 format
from line 1087
10581087
10591088 Confirmation of a deleted vault.
10601089
1090 - `type: "vault_deleted"`
1091
10611092 - `id: string`
10621093
10631094 Unique identifier of the deleted vault.
10641095
1065 - `type: "vault_deleted"`
1066
10671096### Beta Managed Agents Vault
10681097
10691098- `BetaManagedAgentsVault object`
from line 1099
10701099
10711100 A vault that stores credentials for use by agents during sessions.
10721101
1102 - `type: "vault"`
1103
10731104 - `id: string`
10741105
10751106 Unique identifier for the vault.
from line 1125
10941125
10951126 Arbitrary key-value metadata attached to the vault.
10961127
1097 - `type: "vault"`
1098
10991128 - `updated_at: string`
11001129
11011130 A timestamp in RFC 3339 format
from line 1151
11221151
11231152 - `string`
11241153
1125 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
1154 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
11261155
11271156 - `"message-batches-2024-09-24"`
11281157
from line 1199
11701199
11711200 - `"user-profiles-2026-08-18"`
11721201
1202 - `"user-profiles-2026-09-04"`
1203
11731204 - `"advisor-tool-2026-03-01"`
11741205
11751206 - `"managed-agents-2026-04-01"`
from line 1243
12121243
12131244 - `"mid-conversation-system-clear-at-2026-08-21"`
12141245
1246- `"anthropic-workspace-id": optional string`
1247
12151248#### Body parameters
12161249
12171250- `auth: BetaManagedAgentsMCPOAuthCreateParams or BetaManagedAgentsStaticBearerCreateParams or BetaManagedAgentsEnvironmentVariableCreateParams`
from line 1255
12221255
12231256 Parameters for creating an MCP OAuth credential.
12241257
1258 - `type: "mcp_oauth"`
1259
12251260 - `access_token: string`
12261261
12271262 OAuth access token.
from line 1269
12341269
12351270 minLength: 1, maxLength: 2047
12361271
1237 - `type: "mcp_oauth"`
1238
12391272 - `expires_at: optional string or null`
12401273
12411274 A timestamp in RFC 3339 format
from line 1289
12561289
12571290 OAuth refresh token.
12581291
1259 minLength: 1, maxLength: 4096
1292 minLength: 1, maxLength: 8192
12601293
12611294 - `token_endpoint: string`
12621295
from line 1311
12781311
12791312 Token endpoint uses HTTP Basic authentication with client credentials.
12801313
1314 - `type: "client_secret_basic"`
1315
12811316 - `client_secret: string`
12821317
12831318 OAuth client secret.
from line 1319
12841319
12851320 minLength: 1, maxLength: 512
12861321
1287 - `type: "client_secret_basic"`
1288
12891322 - `BetaManagedAgentsTokenEndpointAuthPostParam object`
12901323
12911324 Token endpoint uses POST body authentication with client credentials.
12921325
1326 - `type: "client_secret_post"`
1327
12931328 - `client_secret: string`
12941329
12951330 OAuth client secret.
from line 1331
12961331
12971332 minLength: 1, maxLength: 512
12981333
1299 - `type: "client_secret_post"`
1300
13011334 - `resource: optional string or null`
13021335
13031336 OAuth resource indicator.
from line 1347
13141347
13151348 Parameters for creating a static bearer token credential.
13161349
1350 - `type: "static_bearer"`
1351
13171352 - `token: string`
13181353
13191354 Static bearer token value.
from line 1361
13261361
13271362 minLength: 1, maxLength: 2047
13281363
1329 - `type: "static_bearer"`
1330
13311364 - `BetaManagedAgentsEnvironmentVariableCreateParams object`
13321365
13331366 Parameters for creating an environment variable credential.
13341367
1368 - `type: "environment_variable"`
1369
13351370 - `networking: BetaManagedAgentsCredentialNetworkingParams`
13361371
13371372 Outbound hosts the secret value is substituted on.
from line 1381
13461381
13471382 Substitute the secret only on requests to the listed hosts.
13481383
1384 - `type: "limited"`
1385
13491386 - `allowed_hosts: array of string`
13501387
13511388 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.
13521389
1353 - `type: "limited"`
1354
13551390 - `secret_name: string`
13561391
13571392 Name of the environment variable. Immutable after create.
from line 1399
13641399
13651400 minLength: 1, maxLength: 4096
13661401
1367 - `type: "environment_variable"`
1368
13691402 - `injection_location: optional BetaManagedAgentsInjectionLocationParams`
13701403
13711404 Where in the outbound request the secret value may be substituted.
from line 1427
13941427
13951428 A credential stored in a vault. Sensitive fields are never returned in responses.
13961429
1430 - `type: "vault_credential"`
1431
13971432 - `id: string`
13981433
13991434 Unique identifier for the credential.
from line 1447
14121447
14131448 OAuth credential details for an MCP server.
14141449
1450 - `type: "mcp_oauth"`
1451
14151452 - `mcp_server_url: string`
14161453
14171454 URL of the MCP server this credential authenticates against.
14181455
1419 - `type: "mcp_oauth"`
1420
14211456 - `expires_at: optional string or null`
14221457
14231458 A timestamp in RFC 3339 format
from line 1505
14701505
14711506 Static bearer token credential details for an MCP server.
14721507
1508 - `type: "static_bearer"`
1509
14731510 - `mcp_server_url: string`
14741511
14751512 URL of the MCP server this credential authenticates against.
14761513
1477 - `type: "static_bearer"`
1478
14791514 - `BetaManagedAgentsEnvironmentVariableAuthResponse object`
14801515
14811516 Environment variable credential details. The secret value is never returned.
14821517
1518 - `type: "environment_variable"`
1519
14831520 - `injection_location: BetaManagedAgentsInjectionLocationResponse`
14841521
14851522 Where in the outbound request the secret value is substituted.
from line 1543
15061543
15071544 The secret is substituted only on requests to the listed hosts.
15081545
1546 - `type: "limited"`
1547
15091548 - `allowed_hosts: array of string`
15101549
15111550 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.
15121551
1513 - `type: "limited"`
1514
15151552 - `secret_name: string`
15161553
15171554 Name of the environment variable.
15181555
1519 - `type: "environment_variable"`
1520
15211556 - `created_at: string`
15221557
15231558 A timestamp in RFC 3339 format
from line 1563
15281563
15291564 Arbitrary key-value metadata attached to the credential.
15301565
1531 - `type: "vault_credential"`
1532
15331566 - `updated_at: string`
15341567
15351568 A timestamp in RFC 3339 format
from line 1653
16201653
16211654 - `string`
16221655
1623 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
1656 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
16241657
16251658 - `"message-batches-2024-09-24"`
16261659
from line 1701
16681701
16691702 - `"user-profiles-2026-08-18"`
16701703
1704 - `"user-profiles-2026-09-04"`
1705
16711706 - `"advisor-tool-2026-03-01"`
16721707
16731708 - `"managed-agents-2026-04-01"`
from line 1745
17101745
17111746 - `"mid-conversation-system-clear-at-2026-08-21"`
17121747
1748- `"anthropic-workspace-id": optional string`
1749
17131750#### Returns
17141751
17151752- `data: optional array of BetaManagedAgentsCredential`
from line 1753
17161753
17171754 List of credentials.
17181755
1756 - `type: "vault_credential"`
1757
17191758 - `id: string`
17201759
17211760 Unique identifier for the credential.
from line 1773
17341773
17351774 OAuth credential details for an MCP server.
17361775
1776 - `type: "mcp_oauth"`
1777
17371778 - `mcp_server_url: string`
17381779
17391780 URL of the MCP server this credential authenticates against.
17401781
1741 - `type: "mcp_oauth"`
1742
17431782 - `expires_at: optional string or null`
17441783
17451784 A timestamp in RFC 3339 format
from line 1831
17921831
17931832 Static bearer token credential details for an MCP server.
17941833
1834 - `type: "static_bearer"`
1835
17951836 - `mcp_server_url: string`
17961837
17971838 URL of the MCP server this credential authenticates against.
17981839
1799 - `type: "static_bearer"`
1800
18011840 - `BetaManagedAgentsEnvironmentVariableAuthResponse object`
18021841
18031842 Environment variable credential details. The secret value is never returned.
18041843
1844 - `type: "environment_variable"`
1845
18051846 - `injection_location: BetaManagedAgentsInjectionLocationResponse`
18061847
18071848 Where in the outbound request the secret value is substituted.
from line 1869
18281869
18291870 The secret is substituted only on requests to the listed hosts.
18301871
1872 - `type: "limited"`
1873
18311874 - `allowed_hosts: array of string`
18321875
18331876 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.
18341877
1835 - `type: "limited"`
1836
18371878 - `secret_name: string`
18381879
18391880 Name of the environment variable.
18401881
1841 - `type: "environment_variable"`
1842
18431882 - `created_at: string`
18441883
18451884 A timestamp in RFC 3339 format
from line 1889
18501889
18511890 Arbitrary key-value metadata attached to the credential.
18521891
1853 - `type: "vault_credential"`
1854
18551892 - `updated_at: string`
18561893
18571894 A timestamp in RFC 3339 format
from line 1962
19251962
19261963 - `string`
19271964
1928 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
1965 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
19291966
19301967 - `"message-batches-2024-09-24"`
19311968
from line 2010
19732010
19742011 - `"user-profiles-2026-08-18"`
19752012
2013 - `"user-profiles-2026-09-04"`
2014
19762015 - `"advisor-tool-2026-03-01"`
19772016
19782017 - `"managed-agents-2026-04-01"`
from line 2054
20152054
20162055 - `"mid-conversation-system-clear-at-2026-08-21"`
20172056
2057- `"anthropic-workspace-id": optional string`
2058
20182059#### Returns
20192060
20202061- `BetaManagedAgentsCredential object`
from line 2062
20212062
20222063 A credential stored in a vault. Sensitive fields are never returned in responses.
20232064
2065 - `type: "vault_credential"`
2066
20242067 - `id: string`
20252068
20262069 Unique identifier for the credential.
from line 2082
20392082
20402083 OAuth credential details for an MCP server.
20412084
2085 - `type: "mcp_oauth"`
2086
20422087 - `mcp_server_url: string`
20432088
20442089 URL of the MCP server this credential authenticates against.
20452090
2046 - `type: "mcp_oauth"`
2047
20482091 - `expires_at: optional string or null`
20492092
20502093 A timestamp in RFC 3339 format
from line 2140
20972140
20982141 Static bearer token credential details for an MCP server.
20992142
2143 - `type: "static_bearer"`
2144
21002145 - `mcp_server_url: string`
21012146
21022147 URL of the MCP server this credential authenticates against.
21032148
2104 - `type: "static_bearer"`
2105
21062149 - `BetaManagedAgentsEnvironmentVariableAuthResponse object`
21072150
21082151 Environment variable credential details. The secret value is never returned.
21092152
2153 - `type: "environment_variable"`
2154
21102155 - `injection_location: BetaManagedAgentsInjectionLocationResponse`
21112156
21122157 Where in the outbound request the secret value is substituted.
from line 2178
21332178
21342179 The secret is substituted only on requests to the listed hosts.
21352180
2181 - `type: "limited"`
2182
21362183 - `allowed_hosts: array of string`
21372184
21382185 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.
21392186
2140 - `type: "limited"`
2141
21422187 - `secret_name: string`
21432188
21442189 Name of the environment variable.
21452190
2146 - `type: "environment_variable"`
2147
21482191 - `created_at: string`
21492192
21502193 A timestamp in RFC 3339 format
from line 2198
21552198
21562199 Arbitrary key-value metadata attached to the credential.
21572200
2158 - `type: "vault_credential"`
2159
21602201 - `updated_at: string`
21612202
21622203 A timestamp in RFC 3339 format
from line 2262
22212262
22222263 - `string`
22232264
2224 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
2265 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
22252266
22262267 - `"message-batches-2024-09-24"`
22272268
from line 2310
22692310
22702311 - `"user-profiles-2026-08-18"`
22712312
2313 - `"user-profiles-2026-09-04"`
2314
22722315 - `"advisor-tool-2026-03-01"`
22732316
22742317 - `"managed-agents-2026-04-01"`
from line 2354
23112354
23122355 - `"mid-conversation-system-clear-at-2026-08-21"`
23132356
2357- `"anthropic-workspace-id": optional string`
2358
23142359#### Body parameters
23152360
23162361- `auth: optional BetaManagedAgentsMCPOAuthUpdateParams or BetaManagedAgentsStaticBearerUpdateParams or BetaManagedAgentsEnvironmentVariableUpdateParams`
from line 2388
23432388
23442389 Updated OAuth refresh token.
23452390
2346 minLength: 1, maxLength: 4096
2391 minLength: 1, maxLength: 8192
23472392
23482393 - `scope: optional string or null`
23492394
from line 2468
24232468
24242469 Substitute the secret only on requests to the listed hosts.
24252470
2471 - `type: "limited"`
2472
24262473 - `allowed_hosts: array of string`
24272474
24282475 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.
24292476
2430 - `type: "limited"`
2431
24322477 - `secret_value: optional string or null`
24332478
24342479 Updated secret value.
from line 2496
24512496
24522497 A credential stored in a vault. Sensitive fields are never returned in responses.
24532498
2499 - `type: "vault_credential"`
2500
24542501 - `id: string`
24552502
24562503 Unique identifier for the credential.
from line 2516
24692516
24702517 OAuth credential details for an MCP server.
24712518
2519 - `type: "mcp_oauth"`
2520
24722521 - `mcp_server_url: string`
24732522
24742523 URL of the MCP server this credential authenticates against.
24752524
2476 - `type: "mcp_oauth"`
2477
24782525 - `expires_at: optional string or null`
24792526
24802527 A timestamp in RFC 3339 format
from line 2574
25272574
25282575 Static bearer token credential details for an MCP server.
25292576
2577 - `type: "static_bearer"`
2578
25302579 - `mcp_server_url: string`
25312580
25322581 URL of the MCP server this credential authenticates against.
25332582
2534 - `type: "static_bearer"`
2535
25362583 - `BetaManagedAgentsEnvironmentVariableAuthResponse object`
25372584
25382585 Environment variable credential details. The secret value is never returned.
25392586
2587 - `type: "environment_variable"`
2588
25402589 - `injection_location: BetaManagedAgentsInjectionLocationResponse`
25412590
25422591 Where in the outbound request the secret value is substituted.
from line 2612
25632612
25642613 The secret is substituted only on requests to the listed hosts.
25652614
2615 - `type: "limited"`
2616
25662617 - `allowed_hosts: array of string`
25672618
25682619 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.
25692620
2570 - `type: "limited"`
2571
25722621 - `secret_name: string`
25732622
25742623 Name of the environment variable.
25752624
2576 - `type: "environment_variable"`
2577
25782625 - `created_at: string`
25792626
25802627 A timestamp in RFC 3339 format
from line 2632
25852632
25862633 Arbitrary key-value metadata attached to the credential.
25872634
2588 - `type: "vault_credential"`
2589
25902635 - `updated_at: string`
25912636
25922637 A timestamp in RFC 3339 format
from line 2703
26582703
26592704 - `string`
26602705
2661 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
2706 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
26622707
26632708 - `"message-batches-2024-09-24"`
26642709
from line 2751
27062751
27072752 - `"user-profiles-2026-08-18"`
27082753
2754 - `"user-profiles-2026-09-04"`
2755
27092756 - `"advisor-tool-2026-03-01"`
27102757
27112758 - `"managed-agents-2026-04-01"`
from line 2795
27482795
27492796 - `"mid-conversation-system-clear-at-2026-08-21"`
27502797
2798- `"anthropic-workspace-id": optional string`
2799
27512800#### Returns
27522801
27532802- `BetaManagedAgentsDeletedCredential object`
from line 2803
27542803
27552804 Confirmation of a deleted credential.
27562805
2806 - `type: "vault_credential_deleted"`
2807
27572808 - `id: string`
27582809
27592810 Unique identifier of the deleted credential.
27602811
2761 - `type: "vault_credential_deleted"`
2762
27632812#### Example
27642813
27652814```bash
from line 2848
27992848
28002849 - `string`
28012850
2802 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
2851 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
28032852
28042853 - `"message-batches-2024-09-24"`
28052854
from line 2896
28472896
28482897 - `"user-profiles-2026-08-18"`
28492898
2899 - `"user-profiles-2026-09-04"`
2900
28502901 - `"advisor-tool-2026-03-01"`
28512902
28522903 - `"managed-agents-2026-04-01"`
from line 2940
28892940
28902941 - `"mid-conversation-system-clear-at-2026-08-21"`
28912942
2943- `"anthropic-workspace-id": optional string`
2944
28922945#### Returns
28932946
28942947- `BetaManagedAgentsCredential object`
from line 2948
28952948
28962949 A credential stored in a vault. Sensitive fields are never returned in responses.
28972950
2951 - `type: "vault_credential"`
2952
28982953 - `id: string`
28992954
29002955 Unique identifier for the credential.
from line 2968
29132968
29142969 OAuth credential details for an MCP server.
29152970
2971 - `type: "mcp_oauth"`
2972
29162973 - `mcp_server_url: string`
29172974
29182975 URL of the MCP server this credential authenticates against.
29192976
2920 - `type: "mcp_oauth"`
2921
29222977 - `expires_at: optional string or null`
29232978
29242979 A timestamp in RFC 3339 format
from line 3026
29713026
29723027 Static bearer token credential details for an MCP server.
29733028
3029 - `type: "static_bearer"`
3030
29743031 - `mcp_server_url: string`
29753032
29763033 URL of the MCP server this credential authenticates against.
29773034
2978 - `type: "static_bearer"`
2979
29803035 - `BetaManagedAgentsEnvironmentVariableAuthResponse object`
29813036
29823037 Environment variable credential details. The secret value is never returned.
29833038
3039 - `type: "environment_variable"`
3040
29843041 - `injection_location: BetaManagedAgentsInjectionLocationResponse`
29853042
29863043 Where in the outbound request the secret value is substituted.
from line 3064
30073064
30083065 The secret is substituted only on requests to the listed hosts.
30093066
3067 - `type: "limited"`
3068
30103069 - `allowed_hosts: array of string`
30113070
30123071 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.
30133072
3014 - `type: "limited"`
3015
30163073 - `secret_name: string`
30173074
30183075 Name of the environment variable.
30193076
3020 - `type: "environment_variable"`
3021
30223077 - `created_at: string`
30233078
30243079 A timestamp in RFC 3339 format
from line 3084
30293084
30303085 Arbitrary key-value metadata attached to the credential.
30313086
3032 - `type: "vault_credential"`
3033
30343087 - `updated_at: string`
30353088
30363089 A timestamp in RFC 3339 format
from line 3149
30963149
30973150 - `string`
30983151
3099 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
3152 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
31003153
31013154 - `"message-batches-2024-09-24"`
31023155
from line 3197
31443197
31453198 - `"user-profiles-2026-08-18"`
31463199
3200 - `"user-profiles-2026-09-04"`
3201
31473202 - `"advisor-tool-2026-03-01"`
31483203
31493204 - `"managed-agents-2026-04-01"`
from line 3241
31863241
31873242 - `"mid-conversation-system-clear-at-2026-08-21"`
31883243
3244- `"anthropic-workspace-id": optional string`
3245
31893246#### Returns
31903247
31913248- `BetaManagedAgentsCredentialValidation object`
from line 3249
31923249
31933250 Result of live-probing a credential against its configured MCP server.
31943251
3252 - `type: "vault_credential_validation"`
3253
31953254 - `credential_id: string`
31963255
31973256 Unique identifier of the credential that was validated.
from line 3318
32593318 - `"invalid"`
32603319
32613320 - `"unknown"`
3262
3263 - `type: "vault_credential_validation"`
32643321
32653322 - `validated_at: string`
32663323