Archive Session Thread changedapi/beta/sessions/threads/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+366added
Lines−311removed
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 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
No line in this hunk matches that.