Follow Discord
Sweep 22 Oct 2026 · 04:32Z Build v2.1.308 527 read Stable v2.1.308 Latest v2.1.308 Next v2.1.308 Feeds RSS JSON llms.txt llms-full.txt Unofficial
One change · api

List Sessions changedapi/beta/sessions/list

Nearest release: v2.1.245, published 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+132added
Lines−157removed
From line 1 where the diff opens
First seen 14 Aug 2026 this site's first read of the page
Recorded edits23to this page, all time

# List Sessions ## Query parameters ## Headers ## Returns ## Example ### Response (200) ## List Sessions ### Query Parameters ### Header Parameters ### Returns ### Example #### Response

The whole hunk

from line 1, old and new numbered
/
lines
from line 1
1---
2title: List Sessions
3url: https://platform.claude.com/docs/en/api/beta/sessions/list
4---
1# List Sessions
52 
6## List Sessions
3**GET** `/v1/sessions`
74 
8**get** `/v1/sessions`
9 
105List Sessions
116 
12### Query Parameters
7## Query parameters
138 
149- `agent_id: optional string`
1510 
from line 14
1914 
2015 Filter by agent version. Only applies when agent_id is also set.
2116 
17 format: int32
18 
2219- `"created_at[gt]": optional string`
2320 
2421 Return sessions created after this time (exclusive).
2522 
23 format: date-time
24 
2625- `"created_at[gte]": optional string`
2726 
2827 Return sessions created at or after this time (inclusive).
2928 
29 format: date-time
30 
3031- `"created_at[lt]": optional string`
3132 
3233 Return sessions created before this time (exclusive).
3334 
35 format: date-time
36 
3437- `"created_at[lte]": optional string`
3538 
3639 Return sessions created at or before this time (inclusive).
3740 
41 format: date-time
42 
3843- `deployment_id: optional string`
3944 
4045 Filter sessions created by this deployment ID.
from line 52
4752 
4853 Maximum number of results to return.
4954 
55 format: int32
56 
5057- `memory_store_id: optional string`
5158 
5259 Filter sessions whose resources contain a memory_store with this memory store ID.
from line 82
7582 
7683 - `"terminated"`
7784 
78### Header Parameters
85## Headers
7986 
8087- `"anthropic-beta": optional array of AnthropicBeta`
8188 
from line 160
153160 
154161 - `"mid-conversation-tool-changes-2026-07-01"`
155162 
156### Returns
163## Returns
157164 
158165- `data: optional array of BetaManagedAgentsSession`
159166 
from line 182
175182 
176183 - `type: "url"`
177184 
178 - `"url"`
179 
180185 - `url: string`
181186 
182187 - `model: BetaManagedAgentsModelConfig`
from line 258
253258 
254259 How hard Claude works on each turn. Sets `output_config.effort` on every Messages call the session makes.
255260 
256 - `BetaManagedAgentsEffortLow object { type }`
261 - `BetaManagedAgentsEffortLow object`
257262 
258263 Low effort. Favors latency over reasoning depth.
259264 
260265 - `type: "low"`
261266 
262 - `"low"`
267 - `BetaManagedAgentsEffortMedium object`
263268 
264 - `BetaManagedAgentsEffortMedium object { type }`
265 
266269 Medium effort. Balances latency and reasoning depth.
267270 
268271 - `type: "medium"`
269272 
270 - `"medium"`
273 - `BetaManagedAgentsEffortHigh object`
271274 
272 - `BetaManagedAgentsEffortHigh object { type }`
273 
274275 High effort. Favors reasoning depth.
275276 
276277 - `type: "high"`
277278 
278 - `"high"`
279 - `BetaManagedAgentsEffortXhigh object`
279280 
280 - `BetaManagedAgentsEffortXhigh object { type }`
281 
282281 Extra-high effort. Not all models accept this level.
283282 
284283 - `type: "xhigh"`
285284 
286 - `"xhigh"`
285 - `BetaManagedAgentsEffortMax object`
287286 
288 - `BetaManagedAgentsEffortMax object { type }`
289 
290287 Maximum effort. Favors reasoning depth over latency.
291288 
292289 - `type: "max"`
293290 
294 - `"max"`
295 
296291 - `inference_geo: optional string`
297292 
298293 Geographic region for model inference. When unset, requests fall through to the workspace's default_inference_geo.
from line 308
313308 
314309 Full `agent` definitions the coordinator may spawn as session threads.
315310 
316 - `BetaManagedAgentsSessionThreadAgent object { id, description, mcp_servers, 7 more }`
311 - `BetaManagedAgentsSessionThreadAgent object`
317312 
318313 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`.
319314 
from line 332
337332 
338333 - `skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill`
339334 
340 - `BetaManagedAgentsAnthropicSkill object { skill_id, type, version }`
335 - `BetaManagedAgentsAnthropicSkill object`
341336 
342337 A resolved Anthropic-managed skill.
343338 
from line 340
345340 
346341 - `type: "anthropic"`
347342 
348 - `"anthropic"`
349 
350343 - `version: string`
351344 
352 - `BetaManagedAgentsCustomSkill object { skill_id, type, version }`
345 - `BetaManagedAgentsCustomSkill object`
353346 
354347 A resolved user-created custom skill.
355348 
from line 350
357350 
358351 - `type: "custom"`
359352 
360 - `"custom"`
361 
362353 - `version: string`
363354 
364355 - `system: string or null`
from line 356
365356 
366357 - `tools: array of BetaManagedAgentsAgentToolset20260401 or BetaManagedAgentsMCPToolset or BetaManagedAgentsCustomTool`
367358 
368 - `BetaManagedAgentsAgentToolset20260401 object { configs, default_config, type }`
359 - `BetaManagedAgentsAgentToolset20260401 object`
369360 
370361 - `configs: array of BetaManagedAgentsAgentToolConfig`
371362 
372 - `BetaManagedAgentsBashToolConfig object { enabled, name, permission_policy, type }`
363 - `BetaManagedAgentsBashToolConfig object`
373364 
374365 Configuration for the bash tool.
375366 
from line 368
377368 
378369 - `name: "bash"`
379370 
380 - `"bash"`
381 
382371 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
383372 
384373 Permission policy for tool execution.
385374 
386 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
375 - `BetaManagedAgentsAlwaysAllowPolicy object`
387376 
388377 Tool calls are automatically approved without user confirmation.
389378 
390379 - `type: "always_allow"`
391380 
392 - `"always_allow"`
381 - `BetaManagedAgentsAlwaysAskPolicy object`
393382 
394 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
395 
396383 Tool calls require user confirmation before execution.
397384 
398385 - `type: "always_ask"`
399386 
400 - `"always_ask"`
401 
402387 - `type: "bash"`
403388 
404 - `"bash"`
389 - `BetaManagedAgentsEditToolConfig object`
405390 
406 - `BetaManagedAgentsEditToolConfig object { enabled, name, permission_policy, type }`
407 
408391 Configuration for the edit tool.
409392 
410393 - `enabled: boolean`
from line 394
411394 
412395 - `name: "edit"`
413396 
414 - `"edit"`
415 
416397 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
417398 
418399 Permission policy for tool execution.
419400 
420 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
401 - `BetaManagedAgentsAlwaysAllowPolicy object`
421402 
422403 Tool calls are automatically approved without user confirmation.
423404 
424 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
405 - `BetaManagedAgentsAlwaysAskPolicy object`
425406 
426407 Tool calls require user confirmation before execution.
427408 
428409 - `type: "edit"`
429410 
430 - `"edit"`
411 - `BetaManagedAgentsReadToolConfig object`
431412 
432 - `BetaManagedAgentsReadToolConfig object { enabled, name, permission_policy, type }`
433 
434413 Configuration for the read tool.
435414 
436415 - `enabled: boolean`
from line 416
437416 
438417 - `name: "read"`
439418 
440 - `"read"`
441 
442419 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
443420 
444421 Permission policy for tool execution.
445422 
446 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
423 - `BetaManagedAgentsAlwaysAllowPolicy object`
447424 
448425 Tool calls are automatically approved without user confirmation.
449426 
450 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
427 - `BetaManagedAgentsAlwaysAskPolicy object`
451428 
452429 Tool calls require user confirmation before execution.
453430 
454431 - `type: "read"`
455432 
456 - `"read"`
433 - `BetaManagedAgentsWriteToolConfig object`
457434 
458 - `BetaManagedAgentsWriteToolConfig object { enabled, name, permission_policy, type }`
459 
460435 Configuration for the write tool.
461436 
462437 - `enabled: boolean`
from line 438
463438 
464439 - `name: "write"`
465440 
466 - `"write"`
467 
468441 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
469442 
470443 Permission policy for tool execution.
471444 
472 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
445 - `BetaManagedAgentsAlwaysAllowPolicy object`
473446 
474447 Tool calls are automatically approved without user confirmation.
475448 
476 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
449 - `BetaManagedAgentsAlwaysAskPolicy object`
477450 
478451 Tool calls require user confirmation before execution.
479452 
480453 - `type: "write"`
481454 
482 - `"write"`
455 - `BetaManagedAgentsGlobToolConfig object`
483456 
484 - `BetaManagedAgentsGlobToolConfig object { enabled, name, permission_policy, type }`
485 
486457 Configuration for the glob tool.
487458 
488459 - `enabled: boolean`
from line 460
489460 
490461 - `name: "glob"`
491462 
492 - `"glob"`
493 
494463 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
495464 
496465 Permission policy for tool execution.
497466 
498 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
467 - `BetaManagedAgentsAlwaysAllowPolicy object`
499468 
500469 Tool calls are automatically approved without user confirmation.
501470 
502 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
471 - `BetaManagedAgentsAlwaysAskPolicy object`
503472 
504473 Tool calls require user confirmation before execution.
505474 
506475 - `type: "glob"`
507476 
508 - `"glob"`
477 - `BetaManagedAgentsGrepToolConfig object`
509478 
510 - `BetaManagedAgentsGrepToolConfig object { enabled, name, permission_policy, type }`
511 
512479 Configuration for the grep tool.
513480 
514481 - `enabled: boolean`
from line 482
515482 
516483 - `name: "grep"`
517484 
518 - `"grep"`
519 
520485 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
521486 
522487 Permission policy for tool execution.
523488 
524 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
489 - `BetaManagedAgentsAlwaysAllowPolicy object`
525490 
526491 Tool calls are automatically approved without user confirmation.
527492 
528 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
493 - `BetaManagedAgentsAlwaysAskPolicy object`
529494 
530495 Tool calls require user confirmation before execution.
531496 
532497 - `type: "grep"`
533498 
534 - `"grep"`
499 - `BetaManagedAgentsWebFetchToolConfig object`
535500 
536 - `BetaManagedAgentsWebFetchToolConfig object { enabled, name, permission_policy, 4 more }`
537 
538501 Configuration for the web_fetch tool.
539502 
540503 - `enabled: boolean`
from line 504
541504 
542505 - `name: "web_fetch"`
543506 
544 - `"web_fetch"`
545 
546507 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
547508 
548509 Permission policy for tool execution.
549510 
550 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
511 - `BetaManagedAgentsAlwaysAllowPolicy object`
551512 
552513 Tool calls are automatically approved without user confirmation.
553514 
554 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
515 - `BetaManagedAgentsAlwaysAskPolicy object`
555516 
556517 Tool calls require user confirmation before execution.
557518 
558519 - `type: "web_fetch"`
559520 
560 - `"web_fetch"`
561 
562521 - `allowed_domains: optional array of string`
563522 
564523 - `blocked_domains: optional array of string`
from line 524
565524 
566525 - `max_content_tokens: optional number or null`
567526 
568 - `BetaManagedAgentsWebSearchToolConfig object { enabled, name, permission_policy, 4 more }`
527 format: int32
569528 
529 - `BetaManagedAgentsWebSearchToolConfig object`
530 
570531 Configuration for the web_search tool.
571532 
572533 - `enabled: boolean`
from line 534
573534 
574535 - `name: "web_search"`
575536 
576 - `"web_search"`
577 
578537 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
579538 
580539 Permission policy for tool execution.
581540 
582 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
541 - `BetaManagedAgentsAlwaysAllowPolicy object`
583542 
584543 Tool calls are automatically approved without user confirmation.
585544 
586 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
545 - `BetaManagedAgentsAlwaysAskPolicy object`
587546 
588547 Tool calls require user confirmation before execution.
589548 
590549 - `type: "web_search"`
591550 
592 - `"web_search"`
593 
594551 - `allowed_domains: optional array of string`
595552 
596553 - `blocked_domains: optional array of string`
from line 560
603560 
604561 Location precision. Only "approximate" is supported.
605562 
606 - `"approximate"`
607 
608563 - `city: optional string or null`
609564 
610565 City name.
611566 
567 minLength: 1, maxLength: 255
568 
612569 - `country: optional string or null`
613570 
614571 Two-letter ISO 3166-1 country code, uppercase.
from line 574
617574 
618575 Region or state name.
619576 
577 minLength: 1, maxLength: 255
578 
620579 - `timezone: optional string or null`
621580 
622581 IANA timezone identifier, e.g. "America/Los_Angeles".
623582 
583 minLength: 1, maxLength: 255
584 
624585 - `default_config: BetaManagedAgentsAgentToolsetDefaultConfig`
625586 
626587 Resolved default configuration for agent tools.
from line 592
631592 
632593 Permission policy for tool execution.
633594 
634 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
595 - `BetaManagedAgentsAlwaysAllowPolicy object`
635596 
636597 Tool calls are automatically approved without user confirmation.
637598 
638 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
599 - `BetaManagedAgentsAlwaysAskPolicy object`
639600 
640601 Tool calls require user confirmation before execution.
641602 
642603 - `type: "agent_toolset_20260401"`
643604 
644 - `"agent_toolset_20260401"`
605 - `BetaManagedAgentsMCPToolset object`
645606 
646 - `BetaManagedAgentsMCPToolset object { configs, default_config, mcp_server_name, type }`
647 
648607 - `configs: array of BetaManagedAgentsMCPToolConfig`
649608 
650609 - `enabled: boolean`
from line 614
655614 
656615 Permission policy for tool execution.
657616 
658 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
617 - `BetaManagedAgentsAlwaysAllowPolicy object`
659618 
660619 Tool calls are automatically approved without user confirmation.
661620 
662 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
621 - `BetaManagedAgentsAlwaysAskPolicy object`
663622 
664623 Tool calls require user confirmation before execution.
665624 
from line 632
673632 
674633 Permission policy for tool execution.
675634 
676 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
635 - `BetaManagedAgentsAlwaysAllowPolicy object`
677636 
678637 Tool calls are automatically approved without user confirmation.
679638 
680 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
639 - `BetaManagedAgentsAlwaysAskPolicy object`
681640 
682641 Tool calls require user confirmation before execution.
683642 
from line 644
685644 
686645 - `type: "mcp_toolset"`
687646 
688 - `"mcp_toolset"`
647 - `BetaManagedAgentsCustomTool object`
689648 
690 - `BetaManagedAgentsCustomTool object { description, input_schema, name, type }`
691 
692649 A custom tool as returned in API responses.
693650 
694651 - `description: string`
from line 656
699656 
700657 - `type: "object"`
701658 
702 - `"object"`
703 
704659 - `properties: optional map[unknown] or null`
705660 
706661 - `required: optional array of string or null`
from line 664
709664 
710665 - `type: "custom"`
711666 
712 - `"custom"`
713 
714667 - `type: "agent"`
715668 
716 - `"agent"`
717 
718669 - `version: number`
719670 
720 - `BetaManagedAgentsAdvisor object { model, type }`
671 format: int32
721672 
673 - `BetaManagedAgentsAdvisor object`
674 
722675 Platform advisor roster entry: a model the session's primary thread may consult mid-turn.
723676 
724677 - `model: string`
from line 680
727680 
728681 - `type: "advisor"`
729682 
730 - `"advisor"`
731 
732683 - `type: "coordinator"`
733684 
734 - `"coordinator"`
735 
736685 - `name: string`
737686 
738687 - `skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill`
739688 
740 - `BetaManagedAgentsAnthropicSkill object { skill_id, type, version }`
689 - `BetaManagedAgentsAnthropicSkill object`
741690 
742691 A resolved Anthropic-managed skill.
743692 
744 - `BetaManagedAgentsCustomSkill object { skill_id, type, version }`
693 - `BetaManagedAgentsCustomSkill object`
745694 
746695 A resolved user-created custom skill.
747696 
from line 698
749698 
750699 - `tools: array of BetaManagedAgentsAgentToolset20260401 or BetaManagedAgentsMCPToolset or BetaManagedAgentsCustomTool`
751700 
752 - `BetaManagedAgentsAgentToolset20260401 object { configs, default_config, type }`
701 - `BetaManagedAgentsAgentToolset20260401 object`
753702 
754 - `BetaManagedAgentsMCPToolset object { configs, default_config, mcp_server_name, type }`
703 - `BetaManagedAgentsMCPToolset object`
755704 
756 - `BetaManagedAgentsCustomTool object { description, input_schema, name, type }`
705 - `BetaManagedAgentsCustomTool object`
757706 
758707 A custom tool as returned in API responses.
759708 
760709 - `type: "agent"`
761710 
762 - `"agent"`
763 
764711 - `version: number`
765712 
713 format: int32
714 
766715 - `archived_at: string or null`
767716 
768717 A timestamp in RFC 3339 format
769718 
719 format: date-time
720 
770721 - `budget: BetaManagedAgentsBudgetLimit or null`
771722 
772723 A hard spend ceiling. The session stops issuing new model requests once the tracked list cost reaches `max_list_cost`.
from line 734
783734 
784735 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.
785736 
786 - `"USD"`
787 
788737 - `type: "limit"`
789738 
790 - `"limit"`
791 
792739 - `created_at: string`
793740 
794741 A timestamp in RFC 3339 format
795742 
743 format: date-time
744 
796745 - `environment_id: string`
797746 
798747 - `metadata: map[string]`
from line 754
805754 
806755 A timestamp in RFC 3339 format
807756 
757 format: date-time
758 
808759 - `description: string`
809760 
810761 What the agent should produce.
from line 768
817768 
818769 0-indexed revision cycle the outcome is currently on.
819770 
771 format: int32
772 
820773 - `outcome_id: string`
821774 
822775 Server-generated outc_ ID for this outcome.
from line 780
827780 
828781 - `type: "outcome_evaluation"`
829782 
830 - `"outcome_evaluation"`
831 
832783 - `resources: array of BetaManagedAgentsSessionResource`
833784 
834 - `BetaManagedAgentsGitHubRepositoryResource object { id, created_at, mount_path, 4 more }`
785 - `BetaManagedAgentsGitHubRepositoryResource object`
835786 
836787 - `id: string`
837788 
from line 790
839790 
840791 A timestamp in RFC 3339 format
841792 
793 format: date-time
794 
842795 - `mount_path: string`
843796 
844797 - `type: "github_repository"`
845798 
846 - `"github_repository"`
847 
848799 - `updated_at: string`
849800 
850801 A timestamp in RFC 3339 format
851802 
803 format: date-time
804 
852805 - `url: string`
853806 
854807 - `checkout: optional BetaManagedAgentsBranchCheckout or BetaManagedAgentsCommitCheckout or null`
855808 
856 - `BetaManagedAgentsBranchCheckout object { name, type }`
809 - `BetaManagedAgentsBranchCheckout object`
857810 
858811 - `name: string`
859812 
860813 Branch name to check out.
861814 
815 minLength: 1, maxLength: 255
816 
862817 - `type: "branch"`
863818 
864 - `"branch"`
819 - `BetaManagedAgentsCommitCheckout object`
865820 
866 - `BetaManagedAgentsCommitCheckout object { sha, type }`
867 
868821 - `sha: string`
869822 
870823 Full commit SHA to check out.
871824 
825 minLength: 7, maxLength: 64
826 
872827 - `type: "commit"`
873828 
874 - `"commit"`
829 - `BetaManagedAgentsFileResource object`
875830 
876 - `BetaManagedAgentsFileResource object { id, created_at, file_id, 3 more }`
877 
878831 - `id: string`
879832 
880833 - `created_at: string`
from line 834
881834 
882835 A timestamp in RFC 3339 format
883836 
837 format: date-time
838 
884839 - `file_id: string`
885840 
886841 - `mount_path: string`
from line 842
887842 
888843 - `type: "file"`
889844 
890 - `"file"`
891 
892845 - `updated_at: string`
893846 
894847 A timestamp in RFC 3339 format
895848 
896 - `BetaManagedAgentsMemoryStoreResource object { memory_store_id, type, access, 4 more }`
849 format: date-time
897850 
851 - `BetaManagedAgentsMemoryStoreResource object`
852 
898853 A memory store attached to an agent session.
899854 
900855 - `memory_store_id: string`
from line 858
903858 
904859 - `type: "memory_store"`
905860 
906 - `"memory_store"`
907 
908861 - `access: optional "read_write" or "read_only" or null`
909862 
910863 Access mode for an attached memory store.
from line 874
921874 
922875 Per-attachment guidance for the agent on how to use this store. Rendered into the memory section of the system prompt. Max 4096 chars.
923876 
877 maxLength: 4096
878 
924879 - `mount_path: optional string or null`
925880 
926881 Filesystem path where the store is mounted in the session container, e.g. /mnt/memory/user-preferences. Derived from the store's name. Output-only.
from line 892
937892 
938893 Cumulative time in seconds the session spent in running status. Excludes idle time.
939894 
895 format: double
896 
940897 - `duration_seconds: optional number`
941898 
942899 Elapsed time since session creation in seconds. For terminated sessions, frozen at the final update.
943900 
901 format: double
902 
944903 - `status: "rescheduling" or "running" or "idle" or "terminated"`
945904 
946905 SessionStatus enum
from line 916
957916 
958917 - `type: "session"`
959918 
960 - `"session"`
961 
962919 - `updated_at: string`
963920 
964921 A timestamp in RFC 3339 format
965922 
923 format: date-time
924 
966925 - `usage: BetaManagedAgentsSessionUsage`
967926 
968927 Cumulative token usage for a session across all turns.
from line 930
971930 
972931 Cumulative time in seconds during which the session had at least one thread in running status. Overlapping activity from concurrent threads is counted once, unlike `stats.active_seconds`, which sums each thread's own active time. This is the duration the session's runtime cost is priced on.
973932 
933 format: double
934 
974935 - `cache_creation: optional BetaManagedAgentsCacheCreationUsage`
975936 
976937 Prompt-cache creation token usage broken down by cache lifetime.
from line 940
979940 
980941 Tokens used to create 1-hour ephemeral cache entries.
981942 
943 format: int32
944 
982945 - `ephemeral_5m_input_tokens: optional number`
983946 
984947 Tokens used to create 5-minute ephemeral cache entries.
985948 
949 format: int32
950 
986951 - `cache_read_input_tokens: optional number`
987952 
988953 Total tokens read from prompt cache.
989954 
955 format: int32
956 
990957 - `input_tokens: optional number`
991958 
992959 Total input tokens consumed across all turns.
993960 
961 format: int32
962 
994963 - `list_cost: optional BetaMonetaryAmount or null`
995964 
996965 A monetary amount in a specific currency.
from line 968
999968 
1000969 Total output tokens generated across all turns.
1001970 
971 format: int32
972 
1002973 - `server_tool_use: optional BetaManagedAgentsServerToolUsage or null`
1003974 
1004975 Cumulative count of server-executed tool invocations, broken down by tool.
from line 978
1007978 
1008979 Number of server-executed web fetch requests.
1009980 
981 format: int32
982 
1010983 - `web_search_requests: optional number`
1011984 
1012985 Number of server-executed web search requests.
1013986 
987 format: int32
988 
1014989 - `vault_ids: array of string`
1015990 
1016991 Vault IDs attached to the session at creation. Empty when no vaults were supplied.
from line 1002
10271002 
10281003 Opaque cursor for the previous page. Null when on the first page. Pass as the `page` parameter to navigate backward.
10291004 
1030### Example
1005## Example
10311006 
1032```http
1007```bash
10331008curl https://api.anthropic.com/v1/sessions \
10341009 -H 'anthropic-version: 2023-06-01' \
10351010 -H 'anthropic-beta: managed-agents-2026-04-01' \
from line 1011
10361011 -H "X-Api-Key: $ANTHROPIC_API_KEY"
10371012```
10381013 
1039#### Response
1014### Response (200)
10401015 
10411016```json
10421017{
Feedback