Archive Agent changedapi/beta/agents/archive
Nearest release: v2.1.245, published an hour after this site recorded the change. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.
Recorded here
Lines+72added
Lines−129removed
From line
1
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits23to this page, all time
# Archive Agent ## Path parameters ## Headers ## Returns ## Example ### Response (200) ## Archive Agent ### Path Parameters ### Header Parameters ### Returns ### Example #### Response
The whole hunk
from line 1, old and new numbered
/
from line 1
1---
2title: Archive Agent
3url: https://platform.claude.com/docs/en/api/beta/agents/archive
4---
1# Archive Agent
52
6## Archive Agent
3**POST** `/v1/agents/{agent_id}/archive`
74
8**post** `/v1/agents/{agent_id}/archive`
9
105Archive Agent
116
12### Path Parameters
7## Path parameters
138
149- `agent_id: string`
1510
16### Header Parameters
11## Headers
1712
1813- `"anthropic-beta": optional array of AnthropicBeta`
1914
from line 86
9186
9287 - `"mid-conversation-tool-changes-2026-07-01"`
9388
94### Returns
89## Returns
9590
96- `BetaManagedAgentsAgent object { id, archived_at, created_at, 12 more }`
91- `BetaManagedAgentsAgent object`
9792
9893 A Managed Agents `agent`.
9994
from line 98
10398
10499 A timestamp in RFC 3339 format
105100
101 format: date-time
102
106103 - `created_at: string`
107104
108105 A timestamp in RFC 3339 format
109106
107 format: date-time
108
110109 - `description: string or null`
111110
112111 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
from line 114
115114
116115 - `type: "url"`
117116
118 - `"url"`
119
120117 - `url: string`
121118
122119 - `metadata: map[string]`
from line 192
195192
196193 How hard Claude works on each turn. Sets `output_config.effort` on every Messages call the session makes.
197194
198 - `BetaManagedAgentsEffortLow object { type }`
195 - `BetaManagedAgentsEffortLow object`
199196
200197 Low effort. Favors latency over reasoning depth.
201198
202199 - `type: "low"`
203200
204 - `"low"`
201 - `BetaManagedAgentsEffortMedium object`
205202
206 - `BetaManagedAgentsEffortMedium object { type }`
207
208203 Medium effort. Balances latency and reasoning depth.
209204
210205 - `type: "medium"`
211206
212 - `"medium"`
207 - `BetaManagedAgentsEffortHigh object`
213208
214 - `BetaManagedAgentsEffortHigh object { type }`
215
216209 High effort. Favors reasoning depth.
217210
218211 - `type: "high"`
219212
220 - `"high"`
213 - `BetaManagedAgentsEffortXhigh object`
221214
222 - `BetaManagedAgentsEffortXhigh object { type }`
223
224215 Extra-high effort. Not all models accept this level.
225216
226217 - `type: "xhigh"`
227218
228 - `"xhigh"`
219 - `BetaManagedAgentsEffortMax object`
229220
230 - `BetaManagedAgentsEffortMax object { type }`
231
232221 Maximum effort. Favors reasoning depth over latency.
233222
234223 - `type: "max"`
235224
236 - `"max"`
237
238225 - `inference_geo: optional string`
239226
240227 Geographic region for model inference. When unset, requests fall through to the workspace's default_inference_geo.
from line 242
255242
256243 Agents the coordinator may spawn as session threads, each resolved to a specific version.
257244
258 - `BetaManagedAgentsAgentReference object { id, type, version }`
245 - `BetaManagedAgentsAgentReference object`
259246
260247 A resolved agent reference with a concrete version.
261248
from line 250
263250
264251 - `type: "agent"`
265252
266 - `"agent"`
267
268253 - `version: number`
269254
270 - `BetaManagedAgentsAdvisor object { model, type }`
255 format: int32
271256
257 - `BetaManagedAgentsAdvisor object`
258
272259 Platform advisor roster entry: a model the session's primary thread may consult mid-turn.
273260
274261 - `model: string`
from line 264
277264
278265 - `type: "advisor"`
279266
280 - `"advisor"`
281
282267 - `type: "coordinator"`
283268
284 - `"coordinator"`
285
286269 - `name: string`
287270
288271 - `skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill`
289272
290 - `BetaManagedAgentsAnthropicSkill object { skill_id, type, version }`
273 - `BetaManagedAgentsAnthropicSkill object`
291274
292275 A resolved Anthropic-managed skill.
293276
from line 278
295278
296279 - `type: "anthropic"`
297280
298 - `"anthropic"`
299
300281 - `version: string`
301282
302 - `BetaManagedAgentsCustomSkill object { skill_id, type, version }`
283 - `BetaManagedAgentsCustomSkill object`
303284
304285 A resolved user-created custom skill.
305286
from line 288
307288
308289 - `type: "custom"`
309290
310 - `"custom"`
311
312291 - `version: string`
313292
314293 - `system: string or null`
from line 294
315294
316295 - `tools: array of BetaManagedAgentsAgentToolset20260401 or BetaManagedAgentsMCPToolset or BetaManagedAgentsCustomTool`
317296
318 - `BetaManagedAgentsAgentToolset20260401 object { configs, default_config, type }`
297 - `BetaManagedAgentsAgentToolset20260401 object`
319298
320299 - `configs: array of BetaManagedAgentsAgentToolConfig`
321300
322 - `BetaManagedAgentsBashToolConfig object { enabled, name, permission_policy, type }`
301 - `BetaManagedAgentsBashToolConfig object`
323302
324303 Configuration for the bash tool.
325304
from line 306
327306
328307 - `name: "bash"`
329308
330 - `"bash"`
331
332309 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
333310
334311 Permission policy for tool execution.
335312
336 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
313 - `BetaManagedAgentsAlwaysAllowPolicy object`
337314
338315 Tool calls are automatically approved without user confirmation.
339316
340317 - `type: "always_allow"`
341318
342 - `"always_allow"`
319 - `BetaManagedAgentsAlwaysAskPolicy object`
343320
344 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
345
346321 Tool calls require user confirmation before execution.
347322
348323 - `type: "always_ask"`
349324
350 - `"always_ask"`
351
352325 - `type: "bash"`
353326
354 - `"bash"`
327 - `BetaManagedAgentsEditToolConfig object`
355328
356 - `BetaManagedAgentsEditToolConfig object { enabled, name, permission_policy, type }`
357
358329 Configuration for the edit tool.
359330
360331 - `enabled: boolean`
from line 332
361332
362333 - `name: "edit"`
363334
364 - `"edit"`
365
366335 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
367336
368337 Permission policy for tool execution.
369338
370 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
339 - `BetaManagedAgentsAlwaysAllowPolicy object`
371340
372341 Tool calls are automatically approved without user confirmation.
373342
374 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
343 - `BetaManagedAgentsAlwaysAskPolicy object`
375344
376345 Tool calls require user confirmation before execution.
377346
378347 - `type: "edit"`
379348
380 - `"edit"`
349 - `BetaManagedAgentsReadToolConfig object`
381350
382 - `BetaManagedAgentsReadToolConfig object { enabled, name, permission_policy, type }`
383
384351 Configuration for the read tool.
385352
386353 - `enabled: boolean`
from line 354
387354
388355 - `name: "read"`
389356
390 - `"read"`
391
392357 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
393358
394359 Permission policy for tool execution.
395360
396 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
361 - `BetaManagedAgentsAlwaysAllowPolicy object`
397362
398363 Tool calls are automatically approved without user confirmation.
399364
400 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
365 - `BetaManagedAgentsAlwaysAskPolicy object`
401366
402367 Tool calls require user confirmation before execution.
403368
404369 - `type: "read"`
405370
406 - `"read"`
371 - `BetaManagedAgentsWriteToolConfig object`
407372
408 - `BetaManagedAgentsWriteToolConfig object { enabled, name, permission_policy, type }`
409
410373 Configuration for the write tool.
411374
412375 - `enabled: boolean`
from line 376
413376
414377 - `name: "write"`
415378
416 - `"write"`
417
418379 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
419380
420381 Permission policy for tool execution.
421382
422 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
383 - `BetaManagedAgentsAlwaysAllowPolicy object`
423384
424385 Tool calls are automatically approved without user confirmation.
425386
426 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
387 - `BetaManagedAgentsAlwaysAskPolicy object`
427388
428389 Tool calls require user confirmation before execution.
429390
430391 - `type: "write"`
431392
432 - `"write"`
393 - `BetaManagedAgentsGlobToolConfig object`
433394
434 - `BetaManagedAgentsGlobToolConfig object { enabled, name, permission_policy, type }`
435
436395 Configuration for the glob tool.
437396
438397 - `enabled: boolean`
from line 398
439398
440399 - `name: "glob"`
441400
442 - `"glob"`
443
444401 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
445402
446403 Permission policy for tool execution.
447404
448 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
405 - `BetaManagedAgentsAlwaysAllowPolicy object`
449406
450407 Tool calls are automatically approved without user confirmation.
451408
452 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
409 - `BetaManagedAgentsAlwaysAskPolicy object`
453410
454411 Tool calls require user confirmation before execution.
455412
456413 - `type: "glob"`
457414
458 - `"glob"`
415 - `BetaManagedAgentsGrepToolConfig object`
459416
460 - `BetaManagedAgentsGrepToolConfig object { enabled, name, permission_policy, type }`
461
462417 Configuration for the grep tool.
463418
464419 - `enabled: boolean`
from line 420
465420
466421 - `name: "grep"`
467422
468 - `"grep"`
469
470423 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
471424
472425 Permission policy for tool execution.
473426
474 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
427 - `BetaManagedAgentsAlwaysAllowPolicy object`
475428
476429 Tool calls are automatically approved without user confirmation.
477430
478 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
431 - `BetaManagedAgentsAlwaysAskPolicy object`
479432
480433 Tool calls require user confirmation before execution.
481434
482435 - `type: "grep"`
483436
484 - `"grep"`
437 - `BetaManagedAgentsWebFetchToolConfig object`
485438
486 - `BetaManagedAgentsWebFetchToolConfig object { enabled, name, permission_policy, 4 more }`
487
488439 Configuration for the web_fetch tool.
489440
490441 - `enabled: boolean`
from line 442
491442
492443 - `name: "web_fetch"`
493444
494 - `"web_fetch"`
495
496445 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
497446
498447 Permission policy for tool execution.
499448
500 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
449 - `BetaManagedAgentsAlwaysAllowPolicy object`
501450
502451 Tool calls are automatically approved without user confirmation.
503452
504 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
453 - `BetaManagedAgentsAlwaysAskPolicy object`
505454
506455 Tool calls require user confirmation before execution.
507456
508457 - `type: "web_fetch"`
509458
510 - `"web_fetch"`
511
512459 - `allowed_domains: optional array of string`
513460
514461 - `blocked_domains: optional array of string`
from line 462
515462
516463 - `max_content_tokens: optional number or null`
517464
518 - `BetaManagedAgentsWebSearchToolConfig object { enabled, name, permission_policy, 4 more }`
465 format: int32
519466
467 - `BetaManagedAgentsWebSearchToolConfig object`
468
520469 Configuration for the web_search tool.
521470
522471 - `enabled: boolean`
from line 472
523472
524473 - `name: "web_search"`
525474
526 - `"web_search"`
527
528475 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
529476
530477 Permission policy for tool execution.
531478
532 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
479 - `BetaManagedAgentsAlwaysAllowPolicy object`
533480
534481 Tool calls are automatically approved without user confirmation.
535482
536 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
483 - `BetaManagedAgentsAlwaysAskPolicy object`
537484
538485 Tool calls require user confirmation before execution.
539486
540487 - `type: "web_search"`
541488
542 - `"web_search"`
543
544489 - `allowed_domains: optional array of string`
545490
546491 - `blocked_domains: optional array of string`
from line 498
553498
554499 Location precision. Only "approximate" is supported.
555500
556 - `"approximate"`
557
558501 - `city: optional string or null`
559502
560503 City name.
561504
505 minLength: 1, maxLength: 255
506
562507 - `country: optional string or null`
563508
564509 Two-letter ISO 3166-1 country code, uppercase.
from line 512
567512
568513 Region or state name.
569514
515 minLength: 1, maxLength: 255
516
570517 - `timezone: optional string or null`
571518
572519 IANA timezone identifier, e.g. "America/Los_Angeles".
573520
521 minLength: 1, maxLength: 255
522
574523 - `default_config: BetaManagedAgentsAgentToolsetDefaultConfig`
575524
576525 Resolved default configuration for agent tools.
from line 530
581530
582531 Permission policy for tool execution.
583532
584 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
533 - `BetaManagedAgentsAlwaysAllowPolicy object`
585534
586535 Tool calls are automatically approved without user confirmation.
587536
588 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
537 - `BetaManagedAgentsAlwaysAskPolicy object`
589538
590539 Tool calls require user confirmation before execution.
591540
592541 - `type: "agent_toolset_20260401"`
593542
594 - `"agent_toolset_20260401"`
543 - `BetaManagedAgentsMCPToolset object`
595544
596 - `BetaManagedAgentsMCPToolset object { configs, default_config, mcp_server_name, type }`
597
598545 - `configs: array of BetaManagedAgentsMCPToolConfig`
599546
600547 - `enabled: boolean`
from line 552
605552
606553 Permission policy for tool execution.
607554
608 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
555 - `BetaManagedAgentsAlwaysAllowPolicy object`
609556
610557 Tool calls are automatically approved without user confirmation.
611558
612 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
559 - `BetaManagedAgentsAlwaysAskPolicy object`
613560
614561 Tool calls require user confirmation before execution.
615562
from line 570
623570
624571 Permission policy for tool execution.
625572
626 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
573 - `BetaManagedAgentsAlwaysAllowPolicy object`
627574
628575 Tool calls are automatically approved without user confirmation.
629576
630 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
577 - `BetaManagedAgentsAlwaysAskPolicy object`
631578
632579 Tool calls require user confirmation before execution.
633580
from line 582
635582
636583 - `type: "mcp_toolset"`
637584
638 - `"mcp_toolset"`
585 - `BetaManagedAgentsCustomTool object`
639586
640 - `BetaManagedAgentsCustomTool object { description, input_schema, name, type }`
641
642587 A custom tool as returned in API responses.
643588
644589 - `description: string`
from line 594
649594
650595 - `type: "object"`
651596
652 - `"object"`
653
654597 - `properties: optional map[unknown] or null`
655598
656599 - `required: optional array of string or null`
from line 602
659602
660603 - `type: "custom"`
661604
662 - `"custom"`
663
664605 - `type: "agent"`
665606
666 - `"agent"`
667
668607 - `updated_at: string`
669608
670609 A timestamp in RFC 3339 format
671610
611 format: date-time
612
672613 - `version: number`
673614
674615 The agent's current version. Starts at 1 and increments when the agent is modified.
675616
676### Example
617 format: int32
677618
678```http
619## Example
620
621```bash
679622curl https://api.anthropic.com/v1/agents/$AGENT_ID/archive \
680623 -X POST \
681624 -H 'anthropic-version: 2023-06-01' \
from line 626
683626 -H "X-Api-Key: $ANTHROPIC_API_KEY"
684627```
685628
686#### Response
629### Response (200)
687630
688631```json
689632{
No line in this hunk matches that.