The whole hunk
from line 1, old and new numbered
/
lines
from line 1
1---
2title: Archive Session Thread
3url: https://platform.claude.com/docs/en/api/beta/sessions/threads/archive
4---
5
16# Archive Session Thread
27
38**POST** `/v1/sessions/{session_id}/threads/{thread_id}/archive`
from line 23
1823
1924 - `string`
2025
21 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
26 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
2227
2328 - `"message-batches-2024-09-24"`
2429
from line 71
6671
6772 - `"user-profiles-2026-08-18"`
6873
74 - `"user-profiles-2026-09-04"`
75
6976 - `"advisor-tool-2026-03-01"`
7077
7178 - `"managed-agents-2026-04-01"`
from line 115
108115
109116 - `"mid-conversation-system-clear-at-2026-08-21"`
110117
118- `"anthropic-workspace-id": optional string`
119
111120## Returns
112121
113122- `BetaManagedAgentsSessionThread object`
from line 123
114123
115124 An execution thread within a `session`. Each session has one primary thread plus zero or more child threads spawned by the coordinator.
116125
126 - `type: "session_thread"`
127
117128 - `id: string`
118129
119130 Unique identifier for this thread.
from line 137
126137
127138 Resolved `agent` definition for a single `session_thread`. Snapshot of the agent at thread creation time. The multiagent roster is not repeated here; read it from `Session.agent`.
128139
140 - `type: "agent"`
141
129142 - `id: string`
130143
131144 - `description: string or null`
from line 145
132145
133146 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
134147
135 - `name: string`
136
137148 - `type: "url"`
138149
150 - `name: string`
151
139152 - `url: string`
140153
141154 - `model: BetaManagedAgentsModelConfig`
from line 279
266279
267280 A resolved Anthropic-managed skill.
268281
269 - `skill_id: string`
270
271282 - `type: "anthropic"`
272283
284 - `skill_id: string`
285
273286 - `version: string`
274287
275288 - `BetaManagedAgentsCustomSkill object`
from line 289
276289
277290 A resolved user-created custom skill.
278291
279 - `skill_id: string`
280
281292 - `type: "custom"`
282293
294 - `skill_id: string`
295
283296 - `version: string`
284297
285298 - `system: string or null`
from line 301
288301
289302 - `BetaManagedAgentsAgentToolset20260401 object`
290303
304 - `type: "agent_toolset_20260401"`
305
291306 - `configs: array of BetaManagedAgentsAgentToolConfig`
292307
293308 - `BetaManagedAgentsBashToolConfig object`
from line 309
294309
295310 Configuration for the bash tool.
296311
312 - `type: "bash"`
313
297314 - `enabled: boolean`
298315
299316 - `name: "bash"`
300317
301 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
318 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
302319
303320 Permission policy for tool execution.
304321
from line 331
314331
315332 - `type: "always_ask"`
316333
317 - `type: "bash"`
334 - `BetaManagedAgentsAutoPolicy object`
318335
336 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.
337
338 - `type: "auto"`
339
319340 - `BetaManagedAgentsEditToolConfig object`
320341
321342 Configuration for the edit tool.
322343
344 - `type: "edit"`
345
323346 - `enabled: boolean`
324347
325348 - `name: "edit"`
326349
327 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
350 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
328351
329352 Permission policy for tool execution.
330353
from line 359
336359
337360 Tool calls require user confirmation before execution.
338361
339 - `type: "edit"`
362 - `BetaManagedAgentsAutoPolicy object`
340363
364 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.
365
341366 - `BetaManagedAgentsReadToolConfig object`
342367
343368 Configuration for the read tool.
344369
370 - `type: "read"`
371
345372 - `enabled: boolean`
346373
347374 - `name: "read"`
348375
349 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
376 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
350377
351378 Permission policy for tool execution.
352379
from line 385
358385
359386 Tool calls require user confirmation before execution.
360387
361 - `type: "read"`
388 - `BetaManagedAgentsAutoPolicy object`
362389
390 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.
391
363392 - `BetaManagedAgentsWriteToolConfig object`
364393
365394 Configuration for the write tool.
366395
396 - `type: "write"`
397
367398 - `enabled: boolean`
368399
369400 - `name: "write"`
370401
371 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
402 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
372403
373404 Permission policy for tool execution.
374405
from line 411
380411
381412 Tool calls require user confirmation before execution.
382413
383 - `type: "write"`
414 - `BetaManagedAgentsAutoPolicy object`
384415
416 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.
417
385418 - `BetaManagedAgentsGlobToolConfig object`
386419
387420 Configuration for the glob tool.
388421
422 - `type: "glob"`
423
389424 - `enabled: boolean`
390425
391426 - `name: "glob"`
392427
393 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
428 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
394429
395430 Permission policy for tool execution.
396431
from line 437
402437
403438 Tool calls require user confirmation before execution.
404439
405 - `type: "glob"`
440 - `BetaManagedAgentsAutoPolicy object`
406441
442 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.
443
407444 - `BetaManagedAgentsGrepToolConfig object`
408445
409446 Configuration for the grep tool.
410447
448 - `type: "grep"`
449
411450 - `enabled: boolean`
412451
413452 - `name: "grep"`
414453
415 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
454 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
416455
417456 Permission policy for tool execution.
418457
from line 463
424463
425464 Tool calls require user confirmation before execution.
426465
427 - `type: "grep"`
466 - `BetaManagedAgentsAutoPolicy object`
428467
468 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.
469
429470 - `BetaManagedAgentsWebFetchToolConfig object`
430471
431472 Configuration for the web_fetch tool.
432473
474 - `type: "web_fetch"`
475
433476 - `enabled: boolean`
434477
435478 - `name: "web_fetch"`
436479
437 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
480 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
438481
439482 Permission policy for tool execution.
440483
from line 489
446489
447490 Tool calls require user confirmation before execution.
448491
449 - `type: "web_fetch"`
492 - `BetaManagedAgentsAutoPolicy object`
450493
494 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.
495
451496 - `allowed_domains: optional array of string`
452497
453498 - `blocked_domains: optional array of string`
from line 505
460505
461506 Configuration for the web_search tool.
462507
508 - `type: "web_search"`
509
463510 - `enabled: boolean`
464511
465512 - `name: "web_search"`
466513
467 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
514 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
468515
469516 Permission policy for tool execution.
470517
from line 523
476523
477524 Tool calls require user confirmation before execution.
478525
479 - `type: "web_search"`
526 - `BetaManagedAgentsAutoPolicy object`
480527
528 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.
529
481530 - `allowed_domains: optional array of string`
482531
483532 - `blocked_domains: optional array of string`
from line 567
518567
519568 - `enabled: boolean`
520569
521 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
570 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
522571
523572 Permission policy for tool execution.
524573
from line 579
530579
531580 Tool calls require user confirmation before execution.
532581
533 - `type: "agent_toolset_20260401"`
582 - `BetaManagedAgentsAutoPolicy object`
534583
584 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.
585
535586 - `BetaManagedAgentsMCPToolset object`
536587
588 - `type: "mcp_toolset"`
589
537590 - `configs: array of BetaManagedAgentsMCPToolConfig`
538591
539592 - `enabled: boolean`
from line 593
540593
541594 - `name: string`
542595
543 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
596 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
544597
545598 Permission policy for tool execution.
546599
from line 605
552605
553606 Tool calls require user confirmation before execution.
554607
608 - `BetaManagedAgentsAutoPolicy object`
609
610 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.
611
555612 - `default_config: BetaManagedAgentsMCPToolsetDefaultConfig`
556613
557614 Resolved default configuration for all tools from an MCP server.
from line 615
558615
559616 - `enabled: boolean`
560617
561 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
618 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
562619
563620 Permission policy for tool execution.
564621
from line 627
570627
571628 Tool calls require user confirmation before execution.
572629
573 - `mcp_server_name: string`
630 - `BetaManagedAgentsAutoPolicy object`
574631
575 - `type: "mcp_toolset"`
632 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.
576633
634 - `mcp_server_name: string`
635
577636 - `BetaManagedAgentsCustomTool object`
578637
579638 A custom tool as returned in API responses.
580639
640 - `type: "custom"`
641
581642 - `description: string`
582643
583644 - `input_schema: BetaManagedAgentsCustomToolInputSchema`
from line 653
592653
593654 - `name: string`
594655
595 - `type: "custom"`
596
597 - `type: "agent"`
598
599656 - `version: number`
600657
601658 format: int32
from line 661
604661
605662 Platform advisor roster entry: a model the session's primary thread may consult mid-turn.
606663
664 - `type: "advisor"`
665
607666 - `model: string`
608667
609668 The advisor model id.
610669
611 - `type: "advisor"`
612
613670 - `archived_at: string or null`
614671
615672 A timestamp in RFC 3339 format
from line 720
663720 - `"rescheduling"`
664721
665722 - `"terminated"`
666
667 - `type: "session_thread"`
668723
669724 - `updated_at: string`
670725