Get Session changedapi/beta/sessions/retrieve
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+386added
Lines−331removed
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: Get Session
3url: https://platform.claude.com/docs/en/api/beta/sessions/retrieve
4---
5
16# Get Session
27
38**GET** `/v1/sessions/{session_id}`
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- `BetaManagedAgentsSession object`
from line 121
112121
113122 A Managed Agents `session`.
114123
124 - `type: "session"`
125
115126 - `id: string`
116127
117128 - `agent: BetaManagedAgentsSessionAgent`
from line 129
118129
119130 Resolved `agent` definition for a `session`. Snapshot of the `agent` at `session` creation time.
120131
132 - `type: "agent"`
133
121134 - `id: string`
122135
123136 - `description: string or null`
from line 137
124137
125138 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
126139
127 - `name: string`
128
129140 - `type: "url"`
130141
142 - `name: string`
143
131144 - `url: string`
132145
133146 - `model: BetaManagedAgentsModelConfig`
from line 267
254267
255268 Resolved coordinator topology with full agent definitions for each roster member.
256269
270 - `type: "coordinator"`
271
257272 - `agents: array of BetaManagedAgentsSessionThreadAgent or BetaManagedAgentsAdvisor`
258273
259274 Full `agent` definitions the coordinator may spawn as session threads.
from line 277
262277
263278 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`.
264279
280 - `type: "agent"`
281
265282 - `id: string`
266283
267284 - `description: string or null`
from line 285
268285
269286 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
270287
271 - `name: string`
272
273288 - `type: "url"`
274289
290 - `name: string`
291
275292 - `url: string`
276293
277294 - `model: BetaManagedAgentsModelConfig`
from line 303
286303
287304 A resolved Anthropic-managed skill.
288305
289 - `skill_id: string`
290
291306 - `type: "anthropic"`
292307
308 - `skill_id: string`
309
293310 - `version: string`
294311
295312 - `BetaManagedAgentsCustomSkill object`
from line 313
296313
297314 A resolved user-created custom skill.
298315
299 - `skill_id: string`
300
301316 - `type: "custom"`
302317
318 - `skill_id: string`
319
303320 - `version: string`
304321
305322 - `system: string or null`
from line 325
308325
309326 - `BetaManagedAgentsAgentToolset20260401 object`
310327
328 - `type: "agent_toolset_20260401"`
329
311330 - `configs: array of BetaManagedAgentsAgentToolConfig`
312331
313332 - `BetaManagedAgentsBashToolConfig object`
from line 333
314333
315334 Configuration for the bash tool.
316335
336 - `type: "bash"`
337
317338 - `enabled: boolean`
318339
319340 - `name: "bash"`
320341
321 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
342 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
322343
323344 Permission policy for tool execution.
324345
from line 355
334355
335356 - `type: "always_ask"`
336357
337 - `type: "bash"`
358 - `BetaManagedAgentsAutoPolicy object`
338359
360 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.
361
362 - `type: "auto"`
363
339364 - `BetaManagedAgentsEditToolConfig object`
340365
341366 Configuration for the edit tool.
342367
368 - `type: "edit"`
369
343370 - `enabled: boolean`
344371
345372 - `name: "edit"`
346373
347 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
374 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
348375
349376 Permission policy for tool execution.
350377
from line 383
356383
357384 Tool calls require user confirmation before execution.
358385
359 - `type: "edit"`
386 - `BetaManagedAgentsAutoPolicy object`
360387
388 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.
389
361390 - `BetaManagedAgentsReadToolConfig object`
362391
363392 Configuration for the read tool.
364393
394 - `type: "read"`
395
365396 - `enabled: boolean`
366397
367398 - `name: "read"`
368399
369 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
400 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
370401
371402 Permission policy for tool execution.
372403
from line 409
378409
379410 Tool calls require user confirmation before execution.
380411
381 - `type: "read"`
412 - `BetaManagedAgentsAutoPolicy object`
382413
414 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.
415
383416 - `BetaManagedAgentsWriteToolConfig object`
384417
385418 Configuration for the write tool.
386419
420 - `type: "write"`
421
387422 - `enabled: boolean`
388423
389424 - `name: "write"`
390425
391 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
426 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
392427
393428 Permission policy for tool execution.
394429
from line 435
400435
401436 Tool calls require user confirmation before execution.
402437
403 - `type: "write"`
438 - `BetaManagedAgentsAutoPolicy object`
404439
440 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.
441
405442 - `BetaManagedAgentsGlobToolConfig object`
406443
407444 Configuration for the glob tool.
408445
446 - `type: "glob"`
447
409448 - `enabled: boolean`
410449
411450 - `name: "glob"`
412451
413 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
452 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
414453
415454 Permission policy for tool execution.
416455
from line 461
422461
423462 Tool calls require user confirmation before execution.
424463
425 - `type: "glob"`
464 - `BetaManagedAgentsAutoPolicy object`
426465
466 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.
467
427468 - `BetaManagedAgentsGrepToolConfig object`
428469
429470 Configuration for the grep tool.
430471
472 - `type: "grep"`
473
431474 - `enabled: boolean`
432475
433476 - `name: "grep"`
434477
435 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
478 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
436479
437480 Permission policy for tool execution.
438481
from line 487
444487
445488 Tool calls require user confirmation before execution.
446489
447 - `type: "grep"`
490 - `BetaManagedAgentsAutoPolicy object`
448491
492 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.
493
449494 - `BetaManagedAgentsWebFetchToolConfig object`
450495
451496 Configuration for the web_fetch tool.
452497
498 - `type: "web_fetch"`
499
453500 - `enabled: boolean`
454501
455502 - `name: "web_fetch"`
456503
457 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
504 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
458505
459506 Permission policy for tool execution.
460507
from line 513
466513
467514 Tool calls require user confirmation before execution.
468515
469 - `type: "web_fetch"`
516 - `BetaManagedAgentsAutoPolicy object`
470517
518 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.
519
471520 - `allowed_domains: optional array of string`
472521
473522 - `blocked_domains: optional array of string`
from line 529
480529
481530 Configuration for the web_search tool.
482531
532 - `type: "web_search"`
533
483534 - `enabled: boolean`
484535
485536 - `name: "web_search"`
486537
487 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
538 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
488539
489540 Permission policy for tool execution.
490541
from line 547
496547
497548 Tool calls require user confirmation before execution.
498549
499 - `type: "web_search"`
550 - `BetaManagedAgentsAutoPolicy object`
500551
552 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.
553
501554 - `allowed_domains: optional array of string`
502555
503556 - `blocked_domains: optional array of string`
from line 591
538591
539592 - `enabled: boolean`
540593
541 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
594 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
542595
543596 Permission policy for tool execution.
544597
from line 603
550603
551604 Tool calls require user confirmation before execution.
552605
553 - `type: "agent_toolset_20260401"`
606 - `BetaManagedAgentsAutoPolicy object`
554607
608 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.
609
555610 - `BetaManagedAgentsMCPToolset object`
556611
612 - `type: "mcp_toolset"`
613
557614 - `configs: array of BetaManagedAgentsMCPToolConfig`
558615
559616 - `enabled: boolean`
from line 617
560617
561618 - `name: string`
562619
563 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
620 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
564621
565622 Permission policy for tool execution.
566623
from line 629
572629
573630 Tool calls require user confirmation before execution.
574631
632 - `BetaManagedAgentsAutoPolicy object`
633
634 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.
635
575636 - `default_config: BetaManagedAgentsMCPToolsetDefaultConfig`
576637
577638 Resolved default configuration for all tools from an MCP server.
from line 639
578639
579640 - `enabled: boolean`
580641
581 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
642 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
582643
583644 Permission policy for tool execution.
584645
from line 651
590651
591652 Tool calls require user confirmation before execution.
592653
593 - `mcp_server_name: string`
654 - `BetaManagedAgentsAutoPolicy object`
594655
595 - `type: "mcp_toolset"`
656 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.
596657
658 - `mcp_server_name: string`
659
597660 - `BetaManagedAgentsCustomTool object`
598661
599662 A custom tool as returned in API responses.
600663
664 - `type: "custom"`
665
601666 - `description: string`
602667
603668 - `input_schema: BetaManagedAgentsCustomToolInputSchema`
from line 677
612677
613678 - `name: string`
614679
615 - `type: "custom"`
616
617 - `type: "agent"`
618
619680 - `version: number`
620681
621682 format: int32
from line 685
624685
625686 Platform advisor roster entry: a model the session's primary thread may consult mid-turn.
626687
688 - `type: "advisor"`
689
627690 - `model: string`
628691
629692 The advisor model id.
630693
631 - `type: "advisor"`
632
633 - `type: "coordinator"`
634
635694 - `name: string`
636695
637696 - `skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill`
from line 715
656715
657716 A custom tool as returned in API responses.
658717
659 - `type: "agent"`
660
661718 - `version: number`
662719
663720 format: int32
from line 729
672729
673730 A hard spend ceiling. The session stops issuing new model requests once the tracked list cost reaches `max_list_cost`.
674731
732 - `type: "limit"`
733
675734 - `max_list_cost: BetaMonetaryAmount`
676735
677736 A monetary amount in a specific currency.
from line 743
684743
685744 Uppercase ISO-4217 currency code. `USD` is the only currency currently supported; the accepted set is closed and grows only when a new currency is priced.
686745
687 - `type: "limit"`
688
689746 - `created_at: string`
690747
691748 A timestamp in RFC 3339 format
from line 757
700757
701758 Per-outcome evaluation state. One entry per `define_outcome` event sent to the session.
702759
760 - `type: "outcome_evaluation"`
761
703762 - `completed_at: string or null`
704763
705764 A timestamp in RFC 3339 format
from line 787
728787
729788 Current evaluation state. `pending` before the agent begins work; `running` while producing or revising; `evaluating` while the grader scores; `satisfied`/`max_iterations_reached`/`failed`/`interrupted` are terminal.
730789
731 - `type: "outcome_evaluation"`
732
733790 - `resources: array of BetaManagedAgentsSessionResource`
734791
735792 - `BetaManagedAgentsGitHubRepositoryResource object`
736793
794 - `type: "github_repository"`
795
737796 - `id: string`
738797
739798 - `created_at: string`
from line 803
744803
745804 - `mount_path: string`
746805
747 - `type: "github_repository"`
748
749806 - `updated_at: string`
750807
751808 A timestamp in RFC 3339 format
from line 815
758815
759816 - `BetaManagedAgentsBranchCheckout object`
760817
818 - `type: "branch"`
819
761820 - `name: string`
762821
763822 Branch name to check out.
from line 823
764823
765824 minLength: 1, maxLength: 255
766825
767 - `type: "branch"`
768
769826 - `BetaManagedAgentsCommitCheckout object`
770827
828 - `type: "commit"`
829
771830 - `sha: string`
772831
773832 Full commit SHA to check out.
from line 833
774833
775834 minLength: 7, maxLength: 64
776835
777 - `type: "commit"`
778
779836 - `BetaManagedAgentsFileResource object`
780837
838 - `type: "file"`
839
781840 - `id: string`
782841
783842 - `created_at: string`
from line 849
790849
791850 - `mount_path: string`
792851
793 - `type: "file"`
794
795852 - `updated_at: string`
796853
797854 A timestamp in RFC 3339 format
from line 859
802859
803860 A memory store attached to an agent session.
804861
862 - `type: "memory_store"`
863
805864 - `memory_store_id: string`
806865
807866 The memory store ID (memstore_...). Must belong to the caller's organization and workspace.
808867
809 - `type: "memory_store"`
810
811868 - `access: optional "read_write" or "read_only" or null`
812869
813870 Access mode for an attached memory store.
from line 920
863920 - `"terminated"`
864921
865922 - `title: string or null`
866
867 - `type: "session"`
868923
869924 - `updated_at: string`
870925
No line in this hunk matches that.