The whole hunk
from line 1, old and new numbered
/
lines
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