Archive Agent changedapi/beta/agents/archive
Nearest release: v2.1.268, published under 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+368added
Lines−313removed
From line
1
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits26to this page, all time
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---
5
16# Archive Agent
27
38**POST** `/v1/agents/{agent_id}/archive`
from line 21
1621
1722 - `string`
1823
19 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
24 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
2025
2126 - `"message-batches-2024-09-24"`
2227
from line 69
6469
6570 - `"user-profiles-2026-08-18"`
6671
72 - `"user-profiles-2026-09-04"`
73
6774 - `"advisor-tool-2026-03-01"`
6875
6976 - `"managed-agents-2026-04-01"`
from line 113
106113
107114 - `"mid-conversation-system-clear-at-2026-08-21"`
108115
116- `"anthropic-workspace-id": optional string`
117
109118## Returns
110119
111120- `BetaManagedAgentsAgent object`
from line 121
112121
113122 A Managed Agents `agent`.
114123
124 - `type: "agent"`
125
115126 - `id: string`
116127
117128 - `archived_at: string or null`
from line 141
130141
131142 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
132143
133 - `name: string`
134
135144 - `type: "url"`
136145
146 - `name: string`
147
137148 - `url: string`
138149
139150 - `metadata: map[string]`
from line 273
262273
263274 Resolved coordinator topology with a concrete agent roster.
264275
276 - `type: "coordinator"`
277
265278 - `agents: array of BetaManagedAgentsAgentReference or BetaManagedAgentsAdvisor`
266279
267280 Agents the coordinator may spawn as session threads, each resolved to a specific version.
from line 283
270283
271284 A resolved agent reference with a concrete version.
272285
273 - `id: string`
274
275286 - `type: "agent"`
276287
288 - `id: string`
289
277290 - `version: number`
278291
279292 format: int32
from line 295
282295
283296 Platform advisor roster entry: a model the session's primary thread may consult mid-turn.
284297
298 - `type: "advisor"`
299
285300 - `model: string`
286301
287302 The advisor model id.
288303
289 - `type: "advisor"`
290
291 - `type: "coordinator"`
292
293304 - `name: string`
294305
295306 - `skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill`
from line 309
298309
299310 A resolved Anthropic-managed skill.
300311
301 - `skill_id: string`
302
303312 - `type: "anthropic"`
304313
314 - `skill_id: string`
315
305316 - `version: string`
306317
307318 - `BetaManagedAgentsCustomSkill object`
from line 319
308319
309320 A resolved user-created custom skill.
310321
311 - `skill_id: string`
312
313322 - `type: "custom"`
314323
324 - `skill_id: string`
325
315326 - `version: string`
316327
317328 - `system: string or null`
from line 331
320331
321332 - `BetaManagedAgentsAgentToolset20260401 object`
322333
334 - `type: "agent_toolset_20260401"`
335
323336 - `configs: array of BetaManagedAgentsAgentToolConfig`
324337
325338 - `BetaManagedAgentsBashToolConfig object`
from line 339
326339
327340 Configuration for the bash tool.
328341
342 - `type: "bash"`
343
329344 - `enabled: boolean`
330345
331346 - `name: "bash"`
332347
333 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
348 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
334349
335350 Permission policy for tool execution.
336351
from line 361
346361
347362 - `type: "always_ask"`
348363
349 - `type: "bash"`
364 - `BetaManagedAgentsAutoPolicy object`
350365
366 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
367
368 - `type: "auto"`
369
351370 - `BetaManagedAgentsEditToolConfig object`
352371
353372 Configuration for the edit tool.
354373
374 - `type: "edit"`
375
355376 - `enabled: boolean`
356377
357378 - `name: "edit"`
358379
359 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
380 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
360381
361382 Permission policy for tool execution.
362383
from line 389
368389
369390 Tool calls require user confirmation before execution.
370391
371 - `type: "edit"`
392 - `BetaManagedAgentsAutoPolicy object`
372393
394 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
395
373396 - `BetaManagedAgentsReadToolConfig object`
374397
375398 Configuration for the read tool.
376399
400 - `type: "read"`
401
377402 - `enabled: boolean`
378403
379404 - `name: "read"`
380405
381 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
406 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
382407
383408 Permission policy for tool execution.
384409
from line 415
390415
391416 Tool calls require user confirmation before execution.
392417
393 - `type: "read"`
418 - `BetaManagedAgentsAutoPolicy object`
394419
420 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
421
395422 - `BetaManagedAgentsWriteToolConfig object`
396423
397424 Configuration for the write tool.
398425
426 - `type: "write"`
427
399428 - `enabled: boolean`
400429
401430 - `name: "write"`
402431
403 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
432 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
404433
405434 Permission policy for tool execution.
406435
from line 441
412441
413442 Tool calls require user confirmation before execution.
414443
415 - `type: "write"`
444 - `BetaManagedAgentsAutoPolicy object`
416445
446 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
447
417448 - `BetaManagedAgentsGlobToolConfig object`
418449
419450 Configuration for the glob tool.
420451
452 - `type: "glob"`
453
421454 - `enabled: boolean`
422455
423456 - `name: "glob"`
424457
425 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
458 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
426459
427460 Permission policy for tool execution.
428461
from line 467
434467
435468 Tool calls require user confirmation before execution.
436469
437 - `type: "glob"`
470 - `BetaManagedAgentsAutoPolicy object`
438471
472 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
473
439474 - `BetaManagedAgentsGrepToolConfig object`
440475
441476 Configuration for the grep tool.
442477
478 - `type: "grep"`
479
443480 - `enabled: boolean`
444481
445482 - `name: "grep"`
446483
447 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
484 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
448485
449486 Permission policy for tool execution.
450487
from line 493
456493
457494 Tool calls require user confirmation before execution.
458495
459 - `type: "grep"`
496 - `BetaManagedAgentsAutoPolicy object`
460497
498 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
499
461500 - `BetaManagedAgentsWebFetchToolConfig object`
462501
463502 Configuration for the web_fetch tool.
464503
504 - `type: "web_fetch"`
505
465506 - `enabled: boolean`
466507
467508 - `name: "web_fetch"`
468509
469 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
510 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
470511
471512 Permission policy for tool execution.
472513
from line 519
478519
479520 Tool calls require user confirmation before execution.
480521
481 - `type: "web_fetch"`
522 - `BetaManagedAgentsAutoPolicy object`
482523
524 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
525
483526 - `allowed_domains: optional array of string`
484527
485528 - `blocked_domains: optional array of string`
from line 535
492535
493536 Configuration for the web_search tool.
494537
538 - `type: "web_search"`
539
495540 - `enabled: boolean`
496541
497542 - `name: "web_search"`
498543
499 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
544 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
500545
501546 Permission policy for tool execution.
502547
from line 553
508553
509554 Tool calls require user confirmation before execution.
510555
511 - `type: "web_search"`
556 - `BetaManagedAgentsAutoPolicy object`
512557
558 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
559
513560 - `allowed_domains: optional array of string`
514561
515562 - `blocked_domains: optional array of string`
from line 597
550597
551598 - `enabled: boolean`
552599
553 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
600 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
554601
555602 Permission policy for tool execution.
556603
from line 609
562609
563610 Tool calls require user confirmation before execution.
564611
565 - `type: "agent_toolset_20260401"`
612 - `BetaManagedAgentsAutoPolicy object`
566613
614 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
615
567616 - `BetaManagedAgentsMCPToolset object`
568617
618 - `type: "mcp_toolset"`
619
569620 - `configs: array of BetaManagedAgentsMCPToolConfig`
570621
571622 - `enabled: boolean`
from line 623
572623
573624 - `name: string`
574625
575 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
626 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
576627
577628 Permission policy for tool execution.
578629
from line 635
584635
585636 Tool calls require user confirmation before execution.
586637
638 - `BetaManagedAgentsAutoPolicy object`
639
640 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
641
587642 - `default_config: BetaManagedAgentsMCPToolsetDefaultConfig`
588643
589644 Resolved default configuration for all tools from an MCP server.
from line 645
590645
591646 - `enabled: boolean`
592647
593 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
648 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
594649
595650 Permission policy for tool execution.
596651
from line 657
602657
603658 Tool calls require user confirmation before execution.
604659
605 - `mcp_server_name: string`
660 - `BetaManagedAgentsAutoPolicy object`
606661
607 - `type: "mcp_toolset"`
662 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
608663
664 - `mcp_server_name: string`
665
609666 - `BetaManagedAgentsCustomTool object`
610667
611668 A custom tool as returned in API responses.
612669
670 - `type: "custom"`
671
613672 - `description: string`
614673
615674 - `input_schema: BetaManagedAgentsCustomToolInputSchema`
from line 682
623682 - `required: optional array of string or null`
624683
625684 - `name: string`
626
627 - `type: "custom"`
628
629 - `type: "agent"`
630685
631686 - `updated_at: string`
632687
No line in this hunk matches that.