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