What this read moved
126–150 of 209This capture is too large to show at once. Changes 126-150 of 209 are below, significant first; the rest are on the following screens.
api/beta/sessions Changed · +253 / -67 lines
This page is larger than the 256 KiB this site keeps, so one side of the diff below stops where the stored text does.
from line 14
1414
1515 - `string`
1616
17 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
17 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
1818
1919 - `"message-batches-2024-09-24"`
2020
from line 98
9898
9999 - `"ce-user-management-2026-07-13"`
100100
101 - `"mid-conversation-output-config-2026-07-01"`
102
103 - `"thinking-binding-controls-2026-08-01"`
104
105 - `"mid-conversation-system-clear-at-2026-08-21"`
106
101107### Body parameters
102108
103109- `agent: string or BetaManagedAgentsAgentParams or BetaManagedAgentsAgentWithOverridesParams`
from line 164
158164
159165 Replacement model. Accepts the model string, e.g. `claude-opus-5`, or a `model_config` object. Omit to use the agent's model.
160166
161 - `BetaManagedAgentsModel = "claude-sonnet-5" or "claude-fable-5" or "claude-opus-5" or 10 more or string`
167 - `BetaManagedAgentsModel = "claude-fable-5-1" or "claude-sonnet-5" or "claude-fable-5" or 11 more or string`
162168
163169 The model that will power your agent.
164170
165171 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
166172
167 - `"claude-sonnet-5" or "claude-fable-5" or "claude-opus-5" or 10 more`
173 - `"claude-fable-5-1" or "claude-sonnet-5" or "claude-fable-5" or 11 more`
168174
169175 The model that will power your agent.
170176
171177 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
172178
179 - `"claude-fable-5-1"`
180
181 Frontier intelligence for ambitious tasks across coding, scientific discovery, and enterprise workflows
182
173183 - `"claude-sonnet-5"`
174184
175185 High-performance model for coding and agents
from line 1108
10981108
10991109 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
11001110
1101 - `"claude-sonnet-5" or "claude-fable-5" or "claude-opus-5" or 10 more`
1111 - `"claude-fable-5-1" or "claude-sonnet-5" or "claude-fable-5" or 11 more`
11021112
11031113 The model that will power your agent.
11041114
11051115 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
11061116
1117 - `"claude-fable-5-1"`
1118
1119 Frontier intelligence for ambitious tasks across coding, scientific discovery, and enterprise workflows
1120
11071121 - `"claude-sonnet-5"`
11081122
11091123 High-performance model for coding and agents
from line 1666
16521666
16531667 - `outcome_evaluations: array of BetaManagedAgentsOutcomeEvaluationResource`
16541668
1655 Per-outcome evaluation state. One entry per define_outcome event sent to the session.
1669 Per-outcome evaluation state. One entry per `define_outcome` event sent to the session.
16561670
16571671 - `completed_at: string or null`
16581672
from line 1680
16661680
16671681 - `explanation: string or null`
16681682
1669 Grader's verdict text from the most recent evaluation. For satisfied, explains why criteria are met; for needs_revision (intermediate), what's missing; for failed, why unrecoverable.
1683 Grader's verdict text from the most recent evaluation. For `satisfied`, explains why criteria are met; for `needs_revision` (intermediate), what's missing; for `failed`, why unrecoverable.
16701684
16711685 - `iteration: number`
16721686
from line 1808
17941808
17951809 - `active_seconds: optional number`
17961810
1797 Cumulative time in seconds the session spent in running status. Excludes idle time.
1811 Cumulative time in seconds the session spent in `running` status. Excludes idle time.
17981812
17991813 format: double
18001814
from line 2135
21212135
21222136- `agent_version: optional number`
21232137
2124 Filter by agent version. Only applies when agent_id is also set.
2138 Filter by agent version. Only applies when `agent_id` is also set.
21252139
21262140 format: int32
21272141
from line 2179
21652179
21662180- `memory_store_id: optional string`
21672181
2168 Filter sessions whose resources contain a memory_store with this memory store ID.
2182 Filter sessions whose resources contain a `memory_store` with this memory store ID.
21692183
21702184- `order: optional "asc" or "desc"`
21712185
2172 Sort direction for results, ordered by created_at. Defaults to desc (newest first).
2186 Sort direction for results, ordered by `created_at`. Defaults to `desc` (newest first).
21732187
21742188 - `"asc"`
21752189
from line 2213
21992213
22002214 - `string`
22012215
2202 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
2216 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
22032217
22042218 - `"message-batches-2024-09-24"`
22052219
from line 2297
22832297
22842298 - `"ce-user-management-2026-07-13"`
22852299
2300 - `"mid-conversation-output-config-2026-07-01"`
2301
2302 - `"thinking-binding-controls-2026-08-01"`
2303
2304 - `"mid-conversation-system-clear-at-2026-08-21"`
2305
22862306### Returns
22872307
22882308- `data: optional array of BetaManagedAgentsSession`
from line 2337
23172337
23182338 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
23192339
2320 - `"claude-sonnet-5" or "claude-fable-5" or "claude-opus-5" or 10 more`
2340 - `"claude-fable-5-1" or "claude-sonnet-5" or "claude-fable-5" or 11 more`
23212341
23222342 The model that will power your agent.
23232343
23242344 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
23252345
2346 - `"claude-fable-5-1"`
2347
2348 Frontier intelligence for ambitious tasks across coding, scientific discovery, and enterprise workflows
2349
23262350 - `"claude-sonnet-5"`
23272351
23282352 High-performance model for coding and agents
from line 2895
28712895
28722896 - `outcome_evaluations: array of BetaManagedAgentsOutcomeEvaluationResource`
28732897
2874 Per-outcome evaluation state. One entry per define_outcome event sent to the session.
2898 Per-outcome evaluation state. One entry per `define_outcome` event sent to the session.
28752899
28762900 - `completed_at: string or null`
28772901
from line 2909
28852909
28862910 - `explanation: string or null`
28872911
2888 Grader's verdict text from the most recent evaluation. For satisfied, explains why criteria are met; for needs_revision (intermediate), what's missing; for failed, why unrecoverable.
2912 Grader's verdict text from the most recent evaluation. For `satisfied`, explains why criteria are met; for `needs_revision` (intermediate), what's missing; for `failed`, why unrecoverable.
28892913
28902914 - `iteration: number`
28912915
from line 3037
30133037
30143038 - `active_seconds: optional number`
30153039
3016 Cumulative time in seconds the session spent in running status. Excludes idle time.
3040 Cumulative time in seconds the session spent in `running` status. Excludes idle time.
30173041
30183042 format: double
30193043
from line 3376
33523376
33533377 - `string`
33543378
3355 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
3379 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
33563380
33573381 - `"message-batches-2024-09-24"`
33583382
from line 3460
34363460
34373461 - `"ce-user-management-2026-07-13"`
34383462
3463 - `"mid-conversation-output-config-2026-07-01"`
3464
3465 - `"thinking-binding-controls-2026-08-01"`
3466
3467 - `"mid-conversation-system-clear-at-2026-08-21"`
3468
34393469### Returns
34403470
34413471- `BetaManagedAgentsSession object`
from line 3500
34703500
34713501 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
34723502
3473 - `"claude-sonnet-5" or "claude-fable-5" or "claude-opus-5" or 10 more`
3503 - `"claude-fable-5-1" or "claude-sonnet-5" or "claude-fable-5" or 11 more`
34743504
34753505 The model that will power your agent.
34763506
34773507 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
34783508
3509 - `"claude-fable-5-1"`
3510
3511 Frontier intelligence for ambitious tasks across coding, scientific discovery, and enterprise workflows
3512
34793513 - `"claude-sonnet-5"`
34803514
34813515 High-performance model for coding and agents
from line 4058
40244058
40254059 - `outcome_evaluations: array of BetaManagedAgentsOutcomeEvaluationResource`
40264060
4027 Per-outcome evaluation state. One entry per define_outcome event sent to the session.
4061 Per-outcome evaluation state. One entry per `define_outcome` event sent to the session.
40284062
40294063 - `completed_at: string or null`
40304064
from line 4072
40384072
40394073 - `explanation: string or null`
40404074
4041 Grader's verdict text from the most recent evaluation. For satisfied, explains why criteria are met; for needs_revision (intermediate), what's missing; for failed, why unrecoverable.
4075 Grader's verdict text from the most recent evaluation. For `satisfied`, explains why criteria are met; for `needs_revision` (intermediate), what's missing; for `failed`, why unrecoverable.
40424076
40434077 - `iteration: number`
40444078
from line 4200
41664200
41674201 - `active_seconds: optional number`
41684202
4169 Cumulative time in seconds the session spent in running status. Excludes idle time.
4203 Cumulative time in seconds the session spent in `running` status. Excludes idle time.
41704204
41714205 format: double
41724206
from line 4525
44914525
44924526 - `string`
44934527
4494 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
4528 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
44954529
44964530 - `"message-batches-2024-09-24"`
44974531
from line 4609
45754609
45764610 - `"ce-user-management-2026-07-13"`
45774611
4612 - `"mid-conversation-output-config-2026-07-01"`
4613
4614 - `"thinking-binding-controls-2026-08-01"`
4615
4616 - `"mid-conversation-system-clear-at-2026-08-21"`
4617
45784618### Body parameters
45794619
45804620- `agent: optional BetaManagedAgentsSessionAgentUpdate`
from line 5089
50495089
50505090 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
50515091
5052 - `"claude-sonnet-5" or "claude-fable-5" or "claude-opus-5" or 10 more`
5092 - `"claude-fable-5-1" or "claude-sonnet-5" or "claude-fable-5" or 11 more`
50535093
50545094 The model that will power your agent.
50555095
50565096 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
50575097
5098 - `"claude-fable-5-1"`
5099
5100 Frontier intelligence for ambitious tasks across coding, scientific discovery, and enterprise workflows
5101
50585102 - `"claude-sonnet-5"`
50595103
50605104 High-performance model for coding and agents
from line 5647
56035647
56045648 - `outcome_evaluations: array of BetaManagedAgentsOutcomeEvaluationResource`
56055649
5606 Per-outcome evaluation state. One entry per define_outcome event sent to the session.
5650 Per-outcome evaluation state. One entry per `define_outcome` event sent to the session.
56075651
56085652 - `completed_at: string or null`
56095653
from line 5661
56175661
56185662 - `explanation: string or null`
56195663
5620 Grader's verdict text from the most recent evaluation. For satisfied, explains why criteria are met; for needs_revision (intermediate), what's missing; for failed, why unrecoverable.
5664 Grader's verdict text from the most recent evaluation. For `satisfied`, explains why criteria are met; for `needs_revision` (intermediate), what's missing; for `failed`, why unrecoverable.
56215665
56225666 - `iteration: number`
56235667
from line 5789
57455789
57465790 - `active_seconds: optional number`
57475791
5748 Cumulative time in seconds the session spent in running status. Excludes idle time.
5792 Cumulative time in seconds the session spent in `running` status. Excludes idle time.
57495793
57505794 format: double
57515795
from line 6118
60746118
60756119 - `string`
60766120
6077 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
6121 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
60786122
60796123 - `"message-batches-2024-09-24"`
60806124
from line 6202
61586202
61596203 - `"ce-user-management-2026-07-13"`
61606204
6205 - `"mid-conversation-output-config-2026-07-01"`
6206
6207 - `"thinking-binding-controls-2026-08-01"`
6208
6209 - `"mid-conversation-system-clear-at-2026-08-21"`
6210
61616211### Returns
61626212
61636213- `BetaManagedAgentsDeletedSession object`
from line 6255
62056255
62066256 - `string`
62076257
6208 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
6258 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
62096259
62106260 - `"message-batches-2024-09-24"`
62116261
from line 6339
62896339
62906340 - `"ce-user-management-2026-07-13"`
62916341
6342 - `"mid-conversation-output-config-2026-07-01"`
6343
6344 - `"thinking-binding-controls-2026-08-01"`
6345
6346 - `"mid-conversation-system-clear-at-2026-08-21"`
6347
62926348### Returns
62936349
62946350- `BetaManagedAgentsSession object`
from line 6379
63236379
63246380 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
63256381
6326 - `"claude-sonnet-5" or "claude-fable-5" or "claude-opus-5" or 10 more`
6382 - `"claude-fable-5-1" or "claude-sonnet-5" or "claude-fable-5" or 11 more`
63276383
63286384 The model that will power your agent.
63296385
63306386 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
63316387
6388 - `"claude-fable-5-1"`
6389
6390 Frontier intelligence for ambitious tasks across coding, scientific discovery, and enterprise workflows
6391
63326392 - `"claude-sonnet-5"`
63336393
63346394 High-performance model for coding and agents
from line 6937
68776937
68786938 - `outcome_evaluations: array of BetaManagedAgentsOutcomeEvaluationResource`
68796939
6880 Per-outcome evaluation state. One entry per define_outcome event sent to the session.
6940 Per-outcome evaluation state. One entry per `define_outcome` event sent to the session.
68816941
68826942 - `completed_at: string or null`
68836943
from line 6951
68916951
68926952 - `explanation: string or null`
68936953
6894 Grader's verdict text from the most recent evaluation. For satisfied, explains why criteria are met; for needs_revision (intermediate), what's missing; for failed, why unrecoverable.
6954 Grader's verdict text from the most recent evaluation. For `satisfied`, explains why criteria are met; for `needs_revision` (intermediate), what's missing; for `failed`, why unrecoverable.
68956955
68966956 - `iteration: number`
68976957
from line 7079
70197079
70207080 - `active_seconds: optional number`
70217081
7022 Cumulative time in seconds the session spent in running status. Excludes idle time.
7082 Cumulative time in seconds the session spent in `running` status. Excludes idle time.
70237083
70247084 format: double
70257085
from line 7479
74197479
74207480 Replacement model. Accepts the model string, e.g. `claude-opus-5`, or a `model_config` object. Omit to use the agent's model.
74217481
7422 - `BetaManagedAgentsModel = "claude-sonnet-5" or "claude-fable-5" or "claude-opus-5" or 10 more or string`
7482 - `BetaManagedAgentsModel = "claude-fable-5-1" or "claude-sonnet-5" or "claude-fable-5" or 11 more or string`
74237483
74247484 The model that will power your agent.
74257485
74267486 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
74277487
7428 - `"claude-sonnet-5" or "claude-fable-5" or "claude-opus-5" or 10 more`
7488 - `"claude-fable-5-1" or "claude-sonnet-5" or "claude-fable-5" or 11 more`
74297489
74307490 The model that will power your agent.
74317491
74327492 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
74337493
7494 - `"claude-fable-5-1"`
7495
7496 Frontier intelligence for ambitious tasks across coding, scientific discovery, and enterprise workflows
7497
74347498 - `"claude-sonnet-5"`
74357499
74367500 High-performance model for coding and agents
from line 8425
83618425
83628426- `BetaManagedAgentsOutcomeEvaluationResource object`
83638427
8364 Evaluation state for a single outcome defined via a define_outcome event.
8428 Evaluation state for a single outcome defined via a `define_outcome` event.
83658429
83668430 - `completed_at: string or null`
83678431
from line 8439
83758439
83768440 - `explanation: string or null`
83778441
8378 Grader's verdict text from the most recent evaluation. For satisfied, explains why criteria are met; for needs_revision (intermediate), what's missing; for failed, why unrecoverable.
8442 Grader's verdict text from the most recent evaluation. For `satisfied`, explains why criteria are met; for `needs_revision` (intermediate), what's missing; for `failed`, why unrecoverable.
83798443
83808444 - `iteration: number`
83818445
from line 8509
84458509
84468510 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
84478511
8448 - `"claude-sonnet-5" or "claude-fable-5" or "claude-opus-5" or 10 more`
8512 - `"claude-fable-5-1" or "claude-sonnet-5" or "claude-fable-5" or 11 more`
84498513
84508514 The model that will power your agent.
84518515
84528516 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
84538517
8518 - `"claude-fable-5-1"`
8519
8520 Frontier intelligence for ambitious tasks across coding, scientific discovery, and enterprise workflows
8521
84548522 - `"claude-sonnet-5"`
84558523
84568524 High-performance model for coding and agents
from line 9067
89999067
90009068 - `outcome_evaluations: array of BetaManagedAgentsOutcomeEvaluationResource`
90019069
9002 Per-outcome evaluation state. One entry per define_outcome event sent to the session.
9070 Per-outcome evaluation state. One entry per `define_outcome` event sent to the session.
90039071
90049072 - `completed_at: string or null`
90059073
from line 9081
90139081
90149082 - `explanation: string or null`
90159083
9016 Grader's verdict text from the most recent evaluation. For satisfied, explains why criteria are met; for needs_revision (intermediate), what's missing; for failed, why unrecoverable.
9084 Grader's verdict text from the most recent evaluation. For `satisfied`, explains why criteria are met; for `needs_revision` (intermediate), what's missing; for `failed`, why unrecoverable.
90179085
90189086 - `iteration: number`
90199087
from line 9209
91419209
91429210 - `active_seconds: optional number`
91439211
9144 Cumulative time in seconds the session spent in running status. Excludes idle time.
9212 Cumulative time in seconds the session spent in `running` status. Excludes idle time.
91459213
91469214 format: double
91479215
from line 9341
92739341
92749342 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
92759343
9276 - `"claude-sonnet-5" or "claude-fable-5" or "claude-opus-5" or 10 more`
9344 - `"claude-fable-5-1" or "claude-sonnet-5" or "claude-fable-5" or 11 more`
92779345
92789346 The model that will power your agent.
92799347
92809348 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
92819349
9350 - `"claude-fable-5-1"`
9351
9352 Frontier intelligence for ambitious tasks across coding, scientific discovery, and enterprise workflows
9353
92829354 - `"claude-sonnet-5"`
92839355
92849356 High-performance model for coding and agents
from line 9395
93239395
93249396 Powerful intelligence for long-running agents and coding
93259397
9326 - `"claude-sonnet-4-5"`
9327
9328 High-performance model for agents and coding
9329
9330 - `"claude-sonnet-4-5-20250929"`
9331
9332 High-performance model for agents and coding
9333
9334 - `string`
9335
9336 - `effort: optional BetaManagedAgentsEffortLow or BetaManagedAgentsEffortMedium or BetaManagedAgentsEffortHigh or 2 more`
9337
9338 How hard Claude works on each turn. Sets `output_config.effort` on every Messages call the session makes.
9339
9340 - `BetaManagedAgentsEffortLow object`
9341
9342 Low effort. Favors latency over reasoning depth.
9343
9344 - `type: "low"`
9345
9346 - `BetaManagedAgentsEffortMedium object`
9347
9348 Medium effort. Balances latency and reasoning depth.
9349
9350 - `type: "medium"`
9351
9352 - `BetaManagedAgentsEffortHigh object`
9353
9354 High effort. Favors reasoning depth.
9355
9356 - `type: "high"`
9357
9358 - `BetaManagedAgentsEffortXhigh object`
9359
9360 Extra-high effort. Not all models accept this level.
9361
9362 - `type: "xhigh"`
9363
9364 - `BetaManagedAgentsEffortMax object`
9365
9366 Maximum effort. Favors reasoning depth over latency.
9367
9368 - `type: "max"`
9369
9370 - `inference_geo: optional string`
9371
9372 Geographic region for model inference. When unset, requests fall through to the workspace's default_inference_geo.
9373
9374 - `speed: optional "standard" or "fast"`
9375
9376 Inference speed mode. `fast` provides significantly faster output token generation at premium pricing. Not all models support `fast`; invalid combinations are rejected at create time.
9377
9378 - `"standard"`
9379
9380 - `"fast"`
9381
9382 - `multiagent: BetaManagedAgentsSessionMultiagentCoordinator or null`
9383
9384 Resolved coordinator topology with full agent definitions for each roster member.
9385
9386 - `agents: array of BetaManagedAgentsSessionThreadAgent or BetaManagedAgentsAdvisor`
9387
9388 Full `agent` definitions the coordinator may spawn as session threads.
9389
9390 - `BetaManagedAgentsSessionThreadAgent object`
9391
9392 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`.
9393
9394 - `id: string`
9395
9396 - `description: string or null`
9397
9398 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
9399
9400 - `name: string`
9401
9402 - `type: "url"`
9403
9404 - `url: string`
9405
9406 - `model: BetaManagedAgentsModelConfig`
9407
9408 Model identifier and configuration.
9409
9410
9398 - `"claude-sonnet-4-5
api/beta/sessions/archive Changed · +15 / -5 lines
from line 16
1616
1717 - `string`
1818
19 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
19 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
2020
2121 - `"message-batches-2024-09-24"`
2222
from line 100
100100
101101 - `"ce-user-management-2026-07-13"`
102102
103 - `"mid-conversation-output-config-2026-07-01"`
104
105 - `"thinking-binding-controls-2026-08-01"`
106
107 - `"mid-conversation-system-clear-at-2026-08-21"`
108
103109## Returns
104110
105111- `BetaManagedAgentsSession object`
from line 140
134140
135141 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
136142
137 - `"claude-sonnet-5" or "claude-fable-5" or "claude-opus-5" or 10 more`
143 - `"claude-fable-5-1" or "claude-sonnet-5" or "claude-fable-5" or 11 more`
138144
139145 The model that will power your agent.
140146
141147 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
142148
149 - `"claude-fable-5-1"`
150
151 Frontier intelligence for ambitious tasks across coding, scientific discovery, and enterprise workflows
152
143153 - `"claude-sonnet-5"`
144154
145155 High-performance model for coding and agents
from line 698
688698
689699 - `outcome_evaluations: array of BetaManagedAgentsOutcomeEvaluationResource`
690700
691 Per-outcome evaluation state. One entry per define_outcome event sent to the session.
701 Per-outcome evaluation state. One entry per `define_outcome` event sent to the session.
692702
693703 - `completed_at: string or null`
694704
from line 712
702712
703713 - `explanation: string or null`
704714
705 Grader's verdict text from the most recent evaluation. For satisfied, explains why criteria are met; for needs_revision (intermediate), what's missing; for failed, why unrecoverable.
715 Grader's verdict text from the most recent evaluation. For `satisfied`, explains why criteria are met; for `needs_revision` (intermediate), what's missing; for `failed`, why unrecoverable.
706716
707717 - `iteration: number`
708718
from line 840
830840
831841 - `active_seconds: optional number`
832842
833 Cumulative time in seconds the session spent in running status. Excludes idle time.
843 Cumulative time in seconds the session spent in `running` status. Excludes idle time.
834844
835845 format: double
836846
api/beta/sessions/create Changed · +21 / -7 lines
from line 12
1212
1313 - `string`
1414
15 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
15 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
1616
1717 - `"message-batches-2024-09-24"`
1818
from line 96
9696
9797 - `"ce-user-management-2026-07-13"`
9898
99 - `"mid-conversation-output-config-2026-07-01"`
100
101 - `"thinking-binding-controls-2026-08-01"`
102
103 - `"mid-conversation-system-clear-at-2026-08-21"`
104
99105## Body parameters
100106
101107- `agent: string or BetaManagedAgentsAgentParams or BetaManagedAgentsAgentWithOverridesParams`
from line 162
156162
157163 Replacement model. Accepts the model string, e.g. `claude-opus-5`, or a `model_config` object. Omit to use the agent's model.
158164
159 - `BetaManagedAgentsModel = "claude-sonnet-5" or "claude-fable-5" or "claude-opus-5" or 10 more or string`
165 - `BetaManagedAgentsModel = "claude-fable-5-1" or "claude-sonnet-5" or "claude-fable-5" or 11 more or string`
160166
161167 The model that will power your agent.
162168
163169 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
164170
165 - `"claude-sonnet-5" or "claude-fable-5" or "claude-opus-5" or 10 more`
171 - `"claude-fable-5-1" or "claude-sonnet-5" or "claude-fable-5" or 11 more`
166172
167173 The model that will power your agent.
168174
169175 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
170176
177 - `"claude-fable-5-1"`
178
179 Frontier intelligence for ambitious tasks across coding, scientific discovery, and enterprise workflows
180
171181 - `"claude-sonnet-5"`
172182
173183 High-performance model for coding and agents
from line 1106
10961106
10971107 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
10981108
1099 - `"claude-sonnet-5" or "claude-fable-5" or "claude-opus-5" or 10 more`
1109 - `"claude-fable-5-1" or "claude-sonnet-5" or "claude-fable-5" or 11 more`
11001110
11011111 The model that will power your agent.
11021112
11031113 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
11041114
1115 - `"claude-fable-5-1"`
1116
1117 Frontier intelligence for ambitious tasks across coding, scientific discovery, and enterprise workflows
1118
11051119 - `"claude-sonnet-5"`
11061120
11071121 High-performance model for coding and agents
from line 1664
16501664
16511665 - `outcome_evaluations: array of BetaManagedAgentsOutcomeEvaluationResource`
16521666
1653 Per-outcome evaluation state. One entry per define_outcome event sent to the session.
1667 Per-outcome evaluation state. One entry per `define_outcome` event sent to the session.
16541668
16551669 - `completed_at: string or null`
16561670
from line 1678
16641678
16651679 - `explanation: string or null`
16661680
1667 Grader's verdict text from the most recent evaluation. For satisfied, explains why criteria are met; for needs_revision (intermediate), what's missing; for failed, why unrecoverable.
1681 Grader's verdict text from the most recent evaluation. For `satisfied`, explains why criteria are met; for `needs_revision` (intermediate), what's missing; for `failed`, why unrecoverable.
16681682
16691683 - `iteration: number`
16701684
from line 1806
17921806
17931807 - `active_seconds: optional number`
17941808
1795 Cumulative time in seconds the session spent in running status. Excludes idle time.
1809 Cumulative time in seconds the session spent in `running` status. Excludes idle time.
17961810
17971811 format: double
17981812
api/beta/sessions/delete Changed · +7 / -1 lines
from line 16
1616
1717 - `string`
1818
19 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
19 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
2020
2121 - `"message-batches-2024-09-24"`
2222
from line 99
9999 - `"thinking-display-updates-2026-08-18"`
100100
101101 - `"ce-user-management-2026-07-13"`
102
103 - `"mid-conversation-output-config-2026-07-01"`
104
105 - `"thinking-binding-controls-2026-08-01"`
106
107 - `"mid-conversation-system-clear-at-2026-08-21"`
102108
103109## Returns
104110
api/beta/sessions/events Changed · +43 / -9 lines
This page is larger than the 256 KiB this site keeps, so one side of the diff below stops where the stored text does.
from line 44
4444
4545- `order: optional "asc" or "desc"`
4646
47 Sort direction for results, ordered by the event's `processed_at`. Defaults to asc (chronological).
47 Sort direction for results, ordered by the event's `processed_at`. Defaults to `asc` (chronological).
4848
4949 - `"asc"`
5050
from line 52
5252
5353- `page: optional string`
5454
55 Opaque pagination cursor from a previous response's next_page.
55 Opaque pagination cursor from a previous response's `next_page`.
5656
5757- `types: optional array of string`
5858
from line 66
6666
6767 - `string`
6868
69 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
69 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
7070
7171 - `"message-batches-2024-09-24"`
7272
from line 150
150150
151151 - `"ce-user-management-2026-07-13"`
152152
153 - `"mid-conversation-output-config-2026-07-01"`
154
155 - `"thinking-binding-controls-2026-08-01"`
156
157 - `"mid-conversation-system-clear-at-2026-08-21"`
158
153159### Returns
154160
155161- `data: optional array of BetaManagedAgentsSessionEvent`
from line 1628
16221628
16231629 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
16241630
1625 - `"claude-sonnet-5" or "claude-fable-5" or "claude-opus-5" or 10 more`
1631 - `"claude-fable-5-1" or "claude-sonnet-5" or "claude-fable-5" or 11 more`
16261632
16271633 The model that will power your agent.
16281634
16291635 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
16301636
1637 - `"claude-fable-5-1"`
1638
1639 Frontier intelligence for ambitious tasks across coding, scientific discovery, and enterprise workflows
1640
16311641 - `"claude-sonnet-5"`
16321642
16331643 High-performance model for coding and agents
from line 2351
23412351
23422352 - `string`
23432353
2344 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
2354 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
23452355
23462356 - `"message-batches-2024-09-24"`
23472357
from line 2435
24252435
24262436 - `"ce-user-management-2026-07-13"`
24272437
2438 - `"mid-conversation-output-config-2026-07-01"`
2439
2440 - `"thinking-binding-controls-2026-08-01"`
2441
2442 - `"mid-conversation-system-clear-at-2026-08-21"`
2443
24282444### Body parameters
24292445
24302446- `events: array of BetaManagedAgentsEventParams`
from line 3322
33063322
33073323 - `string`
33083324
3309 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
3325 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
33103326
33113327 - `"message-batches-2024-09-24"`
33123328
from line 3406
33903406
33913407 - `"ce-user-management-2026-07-13"`
33923408
3409 - `"mid-conversation-output-config-2026-07-01"`
3410
3411 - `"thinking-binding-controls-2026-08-01"`
3412
3413 - `"mid-conversation-system-clear-at-2026-08-21"`
3414
33933415### Returns
33943416
33953417- `BetaManagedAgentsStreamSessionEvents = BetaManagedAgentsUserMessageEvent or BetaManagedAgentsUserInterruptEvent or BetaManagedAgentsUserToolConfirmationEvent or 34 more`
from line 4884
48624884
48634885 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
48644886
4865 - `"claude-sonnet-5" or "claude-fable-5" or "claude-opus-5" or 10 more`
4887 - `"claude-fable-5-1" or "claude-sonnet-5" or "claude-fable-5" or 11 more`
48664888
48674889 The model that will power your agent.
48684890
48694891 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
48704892
4893 - `"claude-fable-5-1"`
4894
4895 Frontier intelligence for ambitious tasks across coding, scientific discovery, and enterprise workflows
4896
48714897 - `"claude-sonnet-5"`
48724898
48734899 High-performance model for coding and agents
from line 9335
93099335
93109336 - `explanation: string`
93119337
9312 Human-readable explanation of the verdict. For `needs_revision`, describes which criteria failed and why.
9313
9314 - `iteration: number`
9315
9316 0-indexed revision cycle, matching the corresponding `span.outcome_evaluation_start`.
9317
9318 format: int32
9319
9320 - `outcome_evaluation_start_id: string`
9321
9322 The id of the corresponding `span.outcome_evaluation_start` event.
9323
9324 - `outcome_id: string`
9325
9326 The `outc_` ID of the outcome being evaluated.
9327
9328 - `processed_at: string`
9329
9330 A timestamp in RFC 3339 format
9331
9332 format: date-time
9333
9334 - `result: string`
9335
9336 Evaluation verdict. 'satisfied': criteria met, session goes idle. 'needs_revision': criteria not met, another revision cycle follows. 'max_iterations_reached': evaluation budget exhausted with criteria still unmet — one final acknowledgment turn follows before the s
9338 Human-readable explanation of the verdict. For `need
api/beta/sessions/events/list Changed · +14 / -4 lines
from line 42
4242
4343- `order: optional "asc" or "desc"`
4444
45 Sort direction for results, ordered by the event's `processed_at`. Defaults to asc (chronological).
45 Sort direction for results, ordered by the event's `processed_at`. Defaults to `asc` (chronological).
4646
4747 - `"asc"`
4848
from line 50
5050
5151- `page: optional string`
5252
53 Opaque pagination cursor from a previous response's next_page.
53 Opaque pagination cursor from a previous response's `next_page`.
5454
5555- `types: optional array of string`
5656
from line 64
6464
6565 - `string`
6666
67 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
67 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
6868
6969 - `"message-batches-2024-09-24"`
7070
from line 148
148148
149149 - `"ce-user-management-2026-07-13"`
150150
151 - `"mid-conversation-output-config-2026-07-01"`
152
153 - `"thinking-binding-controls-2026-08-01"`
154
155 - `"mid-conversation-system-clear-at-2026-08-21"`
156
151157## Returns
152158
153159- `data: optional array of BetaManagedAgentsSessionEvent`
from line 1626
16201626
16211627 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
16221628
1623 - `"claude-sonnet-5" or "claude-fable-5" or "claude-opus-5" or 10 more`
1629 - `"claude-fable-5-1" or "claude-sonnet-5" or "claude-fable-5" or 11 more`
16241630
16251631 The model that will power your agent.
16261632
16271633 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
1634
1635 - `"claude-fable-5-1"`
1636
1637 Frontier intelligence for ambitious tasks across coding, scientific discovery, and enterprise workflows
16281638
16291639 - `"claude-sonnet-5"`
16301640
api/beta/sessions/events/send Changed · +7 / -1 lines
from line 16
1616
1717 - `string`
1818
19 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
19 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
2020
2121 - `"message-batches-2024-09-24"`
2222
from line 99
9999 - `"thinking-display-updates-2026-08-18"`
100100
101101 - `"ce-user-management-2026-07-13"`
102
103 - `"mid-conversation-output-config-2026-07-01"`
104
105 - `"thinking-binding-controls-2026-08-01"`
106
107 - `"mid-conversation-system-clear-at-2026-08-21"`
102108
103109## Body parameters
104110
api/beta/sessions/events/stream Changed · +12 / -2 lines
from line 26
2626
2727 - `string`
2828
29 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
29 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
3030
3131 - `"message-batches-2024-09-24"`
3232
from line 110
110110
111111 - `"ce-user-management-2026-07-13"`
112112
113 - `"mid-conversation-output-config-2026-07-01"`
114
115 - `"thinking-binding-controls-2026-08-01"`
116
117 - `"mid-conversation-system-clear-at-2026-08-21"`
118
113119## Returns
114120
115121- `BetaManagedAgentsStreamSessionEvents = BetaManagedAgentsUserMessageEvent or BetaManagedAgentsUserInterruptEvent or BetaManagedAgentsUserToolConfirmationEvent or 34 more`
from line 1588
15821588
15831589 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
15841590
1585 - `"claude-sonnet-5" or "claude-fable-5" or "claude-opus-5" or 10 more`
1591 - `"claude-fable-5-1" or "claude-sonnet-5" or "claude-fable-5" or 11 more`
15861592
15871593 The model that will power your agent.
15881594
15891595 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
1596
1597 - `"claude-fable-5-1"`
1598
1599 Frontier intelligence for ambitious tasks across coding, scientific discovery, and enterprise workflows
15901600
15911601 - `"claude-sonnet-5"`
15921602
api/beta/sessions/list Changed · +18 / -8 lines
from line 12
1212
1313- `agent_version: optional number`
1414
15 Filter by agent version. Only applies when agent_id is also set.
15 Filter by agent version. Only applies when `agent_id` is also set.
1616
1717 format: int32
1818
from line 56
5656
5757- `memory_store_id: optional string`
5858
59 Filter sessions whose resources contain a memory_store with this memory store ID.
59 Filter sessions whose resources contain a `memory_store` with this memory store ID.
6060
6161- `order: optional "asc" or "desc"`
6262
63 Sort direction for results, ordered by created_at. Defaults to desc (newest first).
63 Sort direction for results, ordered by `created_at`. Defaults to `desc` (newest first).
6464
6565 - `"asc"`
6666
from line 90
9090
9191 - `string`
9292
93 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
93 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
9494
9595 - `"message-batches-2024-09-24"`
9696
from line 174
174174
175175 - `"ce-user-management-2026-07-13"`
176176
177 - `"mid-conversation-output-config-2026-07-01"`
178
179 - `"thinking-binding-controls-2026-08-01"`
180
181 - `"mid-conversation-system-clear-at-2026-08-21"`
182
177183## Returns
178184
179185- `data: optional array of BetaManagedAgentsSession`
from line 214
208214
209215 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
210216
211 - `"claude-sonnet-5" or "claude-fable-5" or "claude-opus-5" or 10 more`
217 - `"claude-fable-5-1" or "claude-sonnet-5" or "claude-fable-5" or 11 more`
212218
213219 The model that will power your agent.
214220
215221 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
216222
223 - `"claude-fable-5-1"`
224
225 Frontier intelligence for ambitious tasks across coding, scientific discovery, and enterprise workflows
226
217227 - `"claude-sonnet-5"`
218228
219229 High-performance model for coding and agents
from line 772
762772
763773 - `outcome_evaluations: array of BetaManagedAgentsOutcomeEvaluationResource`
764774
765 Per-outcome evaluation state. One entry per define_outcome event sent to the session.
775 Per-outcome evaluation state. One entry per `define_outcome` event sent to the session.
766776
767777 - `completed_at: string or null`
768778
from line 786
776786
777787 - `explanation: string or null`
778788
779 Grader's verdict text from the most recent evaluation. For satisfied, explains why criteria are met; for needs_revision (intermediate), what's missing; for failed, why unrecoverable.
789 Grader's verdict text from the most recent evaluation. For `satisfied`, explains why criteria are met; for `needs_revision` (intermediate), what's missing; for `failed`, why unrecoverable.
780790
781791 - `iteration: number`
782792
from line 914
904914
905915 - `active_seconds: optional number`
906916
907 Cumulative time in seconds the session spent in running status. Excludes idle time.
917 Cumulative time in seconds the session spent in `running` status. Excludes idle time.
908918
909919 format: double
910920
api/beta/sessions/resources Changed · +36 / -6 lines
from line 18
1818
1919 - `string`
2020
21 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
21 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
2222
2323 - `"message-batches-2024-09-24"`
2424
from line 102
102102
103103 - `"ce-user-management-2026-07-13"`
104104
105 - `"mid-conversation-output-config-2026-07-01"`
106
107 - `"thinking-binding-controls-2026-08-01"`
108
109 - `"mid-conversation-system-clear-at-2026-08-21"`
110
105111### Body parameters
106112
107113- `file_id: string`
from line 196
190196
191197- `page: optional string`
192198
193 Opaque cursor from a previous response's next_page field.
199 Opaque cursor from a previous response's `next_page` field.
194200
195201### Headers
196202
from line 206
200206
201207 - `string`
202208
203 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
209 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
204210
205211 - `"message-batches-2024-09-24"`
206212
from line 290
284290
285291 - `"ce-user-management-2026-07-13"`
286292
293 - `"mid-conversation-output-config-2026-07-01"`
294
295 - `"thinking-binding-controls-2026-08-01"`
296
297 - `"mid-conversation-system-clear-at-2026-08-21"`
298
287299### Returns
288300
289301- `data: array of BetaManagedAgentsSessionResource`
from line 467
455467
456468 - `string`
457469
458 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
470 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
459471
460472 - `"message-batches-2024-09-24"`
461473
from line 551
539551
540552 - `"ce-user-management-2026-07-13"`
541553
554 - `"mid-conversation-output-config-2026-07-01"`
555
556 - `"thinking-binding-controls-2026-08-01"`
557
558 - `"mid-conversation-system-clear-at-2026-08-21"`
559
542560### Returns
543561
544562- `BetaManagedAgentsGitHubRepositoryResource object`
from line 707
689707
690708 - `string`
691709
692 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
710 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
693711
694712 - `"message-batches-2024-09-24"`
695713
from line 791
773791
774792 - `"ce-user-management-2026-07-13"`
775793
794 - `"mid-conversation-output-config-2026-07-01"`
795
796 - `"thinking-binding-controls-2026-08-01"`
797
798 - `"mid-conversation-system-clear-at-2026-08-21"`
799
776800### Body parameters
777801
778802- `authorization_token: string`
from line 959
935959
936960 - `string`
937961
938 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
962 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
939963
940964 - `"message-batches-2024-09-24"`
941965
from line 1042
10181042 - `"thinking-display-updates-2026-08-18"`
10191043
10201044 - `"ce-user-management-2026-07-13"`
1045
1046 - `"mid-conversation-output-config-2026-07-01"`
1047
1048 - `"thinking-binding-controls-2026-08-01"`
1049
1050 - `"mid-conversation-system-clear-at-2026-08-21"`
10211051
10221052### Returns
10231053
api/beta/sessions/resources/add Changed · +7 / -1 lines
from line 16
1616
1717 - `string`
1818
19 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
19 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
2020
2121 - `"message-batches-2024-09-24"`
2222
from line 99
9999 - `"thinking-display-updates-2026-08-18"`
100100
101101 - `"ce-user-management-2026-07-13"`
102
103 - `"mid-conversation-output-config-2026-07-01"`
104
105 - `"thinking-binding-controls-2026-08-01"`
106
107 - `"mid-conversation-system-clear-at-2026-08-21"`
102108
103109## Body parameters
104110
api/beta/sessions/resources/delete Changed · +7 / -1 lines
from line 18
1818
1919 - `string`
2020
21 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
21 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
2222
2323 - `"message-batches-2024-09-24"`
2424
from line 101
101101 - `"thinking-display-updates-2026-08-18"`
102102
103103 - `"ce-user-management-2026-07-13"`
104
105 - `"mid-conversation-output-config-2026-07-01"`
106
107 - `"thinking-binding-controls-2026-08-01"`
108
109 - `"mid-conversation-system-clear-at-2026-08-21"`
104110
105111## Returns
106112
api/beta/sessions/resources/list Changed · +8 / -2 lines
from line 18
1818
1919- `page: optional string`
2020
21 Opaque cursor from a previous response's next_page field.
21 Opaque cursor from a previous response's `next_page` field.
2222
2323## Headers
2424
from line 28
2828
2929 - `string`
3030
31 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
31 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
3232
3333 - `"message-batches-2024-09-24"`
3434
from line 111
111111 - `"thinking-display-updates-2026-08-18"`
112112
113113 - `"ce-user-management-2026-07-13"`
114
115 - `"mid-conversation-output-config-2026-07-01"`
116
117 - `"thinking-binding-controls-2026-08-01"`
118
119 - `"mid-conversation-system-clear-at-2026-08-21"`
114120
115121## Returns
116122
api/beta/sessions/resources/retrieve Changed · +7 / -1 lines
from line 18
1818
1919 - `string`
2020
21 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
21 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
2222
2323 - `"message-batches-2024-09-24"`
2424
from line 101
101101 - `"thinking-display-updates-2026-08-18"`
102102
103103 - `"ce-user-management-2026-07-13"`
104
105 - `"mid-conversation-output-config-2026-07-01"`
106
107 - `"thinking-binding-controls-2026-08-01"`
108
109 - `"mid-conversation-system-clear-at-2026-08-21"`
104110
105111## Returns
106112
api/beta/sessions/resources/update Changed · +7 / -1 lines
from line 18
1818
1919 - `string`
2020
21 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
21 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
2222
2323 - `"message-batches-2024-09-24"`
2424
from line 101
101101 - `"thinking-display-updates-2026-08-18"`
102102
103103 - `"ce-user-management-2026-07-13"`
104
105 - `"mid-conversation-output-config-2026-07-01"`
106
107 - `"thinking-binding-controls-2026-08-01"`
108
109 - `"mid-conversation-system-clear-at-2026-08-21"`
104110
105111## Body parameters
106112
api/beta/sessions/retrieve Changed · +15 / -5 lines
from line 16
1616
1717 - `string`
1818
19 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
19 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
2020
2121 - `"message-batches-2024-09-24"`
2222
from line 100
100100
101101 - `"ce-user-management-2026-07-13"`
102102
103 - `"mid-conversation-output-config-2026-07-01"`
104
105 - `"thinking-binding-controls-2026-08-01"`
106
107 - `"mid-conversation-system-clear-at-2026-08-21"`
108
103109## Returns
104110
105111- `BetaManagedAgentsSession object`
from line 140
134140
135141 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
136142
137 - `"claude-sonnet-5" or "claude-fable-5" or "claude-opus-5" or 10 more`
143 - `"claude-fable-5-1" or "claude-sonnet-5" or "claude-fable-5" or 11 more`
138144
139145 The model that will power your agent.
140146
141147 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
142148
149 - `"claude-fable-5-1"`
150
151 Frontier intelligence for ambitious tasks across coding, scientific discovery, and enterprise workflows
152
143153 - `"claude-sonnet-5"`
144154
145155 High-performance model for coding and agents
from line 698
688698
689699 - `outcome_evaluations: array of BetaManagedAgentsOutcomeEvaluationResource`
690700
691 Per-outcome evaluation state. One entry per define_outcome event sent to the session.
701 Per-outcome evaluation state. One entry per `define_outcome` event sent to the session.
692702
693703 - `completed_at: string or null`
694704
from line 712
702712
703713 - `explanation: string or null`
704714
705 Grader's verdict text from the most recent evaluation. For satisfied, explains why criteria are met; for needs_revision (intermediate), what's missing; for failed, why unrecoverable.
715 Grader's verdict text from the most recent evaluation. For `satisfied`, explains why criteria are met; for `needs_revision` (intermediate), what's missing; for `failed`, why unrecoverable.
706716
707717 - `iteration: number`
708718
from line 840
830840
831841 - `active_seconds: optional number`
832842
833 Cumulative time in seconds the session spent in running status. Excludes idle time.
843 Cumulative time in seconds the session spent in `running` status. Excludes idle time.
834844
835845 format: double
836846
api/beta/sessions/threads Changed · +71 / -13 lines
This page is larger than the 256 KiB this site keeps, so one side of the diff below stops where the stored text does.
from line 20
2020
2121- `page: optional string`
2222
23 Opaque pagination cursor from a previous response's next_page. Forward-only.
23 Opaque pagination cursor from a previous response's `next_page`. Forward-only.
2424
2525### Headers
2626
from line 30
3030
3131 - `string`
3232
33 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
33 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
3434
3535 - `"message-batches-2024-09-24"`
3636
from line 114
114114
115115 - `"ce-user-management-2026-07-13"`
116116
117 - `"mid-conversation-output-config-2026-07-01"`
118
119 - `"thinking-binding-controls-2026-08-01"`
120
121 - `"mid-conversation-system-clear-at-2026-08-21"`
122
117123### Returns
118124
119125- `data: optional array of BetaManagedAgentsSessionThread`
from line 160
154160
155161 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
156162
157 - `"claude-sonnet-5" or "claude-fable-5" or "claude-opus-5" or 10 more`
163 - `"claude-fable-5-1" or "claude-sonnet-5" or "claude-fable-5" or 11 more`
158164
159165 The model that will power your agent.
160166
161167 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
162168
169 - `"claude-fable-5-1"`
170
171 Frontier intelligence for ambitious tasks across coding, scientific discovery, and enterprise workflows
172
163173 - `"claude-sonnet-5"`
164174
165175 High-performance model for coding and agents
from line 883
873883
874884 - `string`
875885
876 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
886 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
877887
878888 - `"message-batches-2024-09-24"`
879889
from line 967
957967
958968 - `"ce-user-management-2026-07-13"`
959969
970 - `"mid-conversation-output-config-2026-07-01"`
971
972 - `"thinking-binding-controls-2026-08-01"`
973
974 - `"mid-conversation-system-clear-at-2026-08-21"`
975
960976### Returns
961977
962978- `BetaManagedAgentsSessionThread object`
from line 1013
9971013
9981014 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
9991015
1000 - `"claude-sonnet-5" or "claude-fable-5" or "claude-opus-5" or 10 more`
1016 - `"claude-fable-5-1" or "claude-sonnet-5" or "claude-fable-5" or 11 more`
10011017
10021018 The model that will power your agent.
10031019
10041020 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
10051021
1022 - `"claude-fable-5-1"`
1023
1024 Frontier intelligence for ambitious tasks across coding, scientific discovery, and enterprise workflows
1025
10061026 - `"claude-sonnet-5"`
10071027
10081028 High-performance model for coding and agents
from line 1727
17071727
17081728 - `string`
17091729
1710 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
1730 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
17111731
17121732 - `"message-batches-2024-09-24"`
17131733
from line 1811
17911811
17921812 - `"ce-user-management-2026-07-13"`
17931813
1814 - `"mid-conversation-output-config-2026-07-01"`
1815
1816 - `"thinking-binding-controls-2026-08-01"`
1817
1818 - `"mid-conversation-system-clear-at-2026-08-21"`
1819
17941820### Returns
17951821
17961822- `BetaManagedAgentsSessionThread object`
from line 1857
18311857
18321858 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
18331859
1834 - `"claude-sonnet-5" or "claude-fable-5" or "claude-opus-5" or 10 more`
1860 - `"claude-fable-5-1" or "claude-sonnet-5" or "claude-fable-5" or 11 more`
18351861
18361862 The model that will power your agent.
18371863
18381864 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
18391865
1866 - `"claude-fable-5-1"`
1867
1868 Frontier intelligence for ambitious tasks across coding, scientific discovery, and enterprise workflows
1869
18401870 - `"claude-sonnet-5"`
18411871
18421872 High-performance model for coding and agents
from line 2594
25642594
25652595 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
25662596
2567 - `"claude-sonnet-5" or "claude-fable-5" or "claude-opus-5" or 10 more`
2597 - `"claude-fable-5-1" or "claude-sonnet-5" or "claude-fable-5" or 11 more`
25682598
25692599 The model that will power your agent.
25702600
25712601 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
25722602
2603 - `"claude-fable-5-1"`
2604
2605 Frontier intelligence for ambitious tasks across coding, scientific discovery, and enterprise workflows
2606
25732607 - `"claude-sonnet-5"`
25742608
25752609 High-performance model for coding and agents
from line 4774
47404774
47414775 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
47424776
4743 - `"claude-sonnet-5" or "claude-fable-5" or "claude-opus-5" or 10 more`
4777 - `"claude-fable-5-1" or "claude-sonnet-5" or "claude-fable-5" or 11 more`
47444778
47454779 The model that will power your agent.
47464780
47474781 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
47484782
4783 - `"claude-fable-5-1"`
4784
4785 Frontier intelligence for ambitious tasks across coding, scientific discovery, and enterprise workflows
4786
47494787 - `"claude-sonnet-5"`
47504788
47514789 High-performance model for coding and agents
from line 5520
54825520
54835521 - `string`
54845522
5485 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
5523 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
54865524
54875525 - `"message-batches-2024-09-24"`
54885526
from line 5604
55665604
55675605 - `"ce-user-management-2026-07-13"`
55685606
5607 - `"mid-conversation-output-config-2026-07-01"`
5608
5609 - `"thinking-binding-controls-2026-08-01"`
5610
5611 - `"mid-conversation-system-clear-at-2026-08-21"`
5612
55695613#### Returns
55705614
55715615- `data: optional array of BetaManagedAgentsSessionEvent`
from line 7082
70387082
70397083 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
70407084
7041 - `"claude-sonnet-5" or "claude-fable-5" or "claude-opus-5" or 10 more`
7085 - `"claude-fable-5-1" or "claude-sonnet-5" or "claude-fable-5" or 11 more`
70427086
70437087 The model that will power your agent.
70447088
70457089 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
70467090
7091 - `"claude-fable-5-1"`
7092
7093 Frontier intelligence for ambitious tasks across coding, scientific discovery, and enterprise workflows
7094
70477095 - `"claude-sonnet-5"`
70487096
70497097 High-performance model for coding and agents
from line 7806
77587806
77597807 - `string`
77607808
7761 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
7809 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
77627810
77637811 - `"message-batches-2024-09-24"`
77647812
from line 7890
78427890
78437891 - `"ce-user-management-2026-07-13"`
78447892
7893 - `"mid-conversation-output-config-2026-07-01"`
7894
7895 - `"thinking-binding-controls-2026-08-01"`
7896
7897 - `"mid-conversation-system-clear-at-2026-08-21"`
7898
78457899#### Returns
78467900
78477901- `BetaManagedAgentsStreamSessionThreadEvents = BetaManagedAgentsUserMessageEvent or BetaManagedAgentsUserInterruptEvent or BetaManagedAgentsUserToolConfirmationEvent or 34 more`
from line 9266
92129266
92139267 The id of the `agent.tool_use` event this result corresponds to, which can be found in the last `session.status_idle` [event's](https://platform.claude.com/docs/en/api/beta/sessions/events/list#beta_managed_agents_session_requires_action.event_ids) `stop_reason.event_ids` field.
92149268
9215 - `type: "user.tool_result"`
9216
9217 - `content: optional array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock or BetaManagedAgentsSearchResultBlock`
9218
9219 The result content returned by the tool.
9220
9221 - `BetaManagedAgentsTextBlock object`
9222
9223 Regular text content.
9224
9225 - `BetaManagedAgentsImageBlock object`
9226
9227 Image content specified directly as base64 data or as a reference via a URL.
9228
9229 - `BetaManagedAgentsDocumentBlock object`
9230
9231 Document content, either specified directly as base64 data, as text, or as a reference via a URL.
9232
9233 - `BetaManagedAgentsSearchResultBlock object`
9234
9235 A block containing a web search result.
9236
9237 - `is_error: optional boolean or null`
9238
9239 Whether the tool execution resulted in an error.
9240
9241 - `processed_at: optional string or null`
9242
9243 A timestamp in RFC 3339 format
9244
9245 format: date-time
9246
9247 - `session_thread_id: optional string or null`
9248
9249 Routes this result to a subagent thread. Copy from the `agent.tool_use` event's `session_thread_id`.
9250
9251 - `BetaManagedAgentsSessionThreadStatusRescheduledEvent object`
9252
9253 A session thread hit a transient error and is retrying automatically. Emitted on the thread's own stream and cross-posted to the primary stream for child threads.
9254
9255 - `id: string`
9256
9257 Unique identifier for this event.
9258
9259 - `agent_name: string`
9260
9261 Name of the agent the thread runs.
9262
9263 - `processed_at: string`
9264
9265 A timestamp in RFC 3339 format
9266
9267 format: date-time
9268
9269 - `session_thread_id: string`
9270
9271 Public sthr_ ID of the thread that is retrying.
9272
9273 - `type: "session.thread_status_rescheduled"`
9274
9275 - `BetaManagedAgentsSessionUpdatedEvent object`
9276
9277 Emit
9269 - `type:
api/beta/sessions/threads/archive Changed · +12 / -2 lines
from line 18
1818
1919 - `string`
2020
21 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
21 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
2222
2323 - `"message-batches-2024-09-24"`
2424
from line 102
102102
103103 - `"ce-user-management-2026-07-13"`
104104
105 - `"mid-conversation-output-config-2026-07-01"`
106
107 - `"thinking-binding-controls-2026-08-01"`
108
109 - `"mid-conversation-system-clear-at-2026-08-21"`
110
105111## Returns
106112
107113- `BetaManagedAgentsSessionThread object`
from line 148
142148
143149 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
144150
145 - `"claude-sonnet-5" or "claude-fable-5" or "claude-opus-5" or 10 more`
151 - `"claude-fable-5-1" or "claude-sonnet-5" or "claude-fable-5" or 11 more`
146152
147153 The model that will power your agent.
148154
149155 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
156
157 - `"claude-fable-5-1"`
158
159 Frontier intelligence for ambitious tasks across coding, scientific discovery, and enterprise workflows
150160
151161 - `"claude-sonnet-5"`
152162
api/beta/sessions/threads/events Changed · +24 / -4 lines
from line 32
3232
3333 - `string`
3434
35 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
35 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
3636
3737 - `"message-batches-2024-09-24"`
3838
from line 116
116116
117117 - `"ce-user-management-2026-07-13"`
118118
119 - `"mid-conversation-output-config-2026-07-01"`
120
121 - `"thinking-binding-controls-2026-08-01"`
122
123 - `"mid-conversation-system-clear-at-2026-08-21"`
124
119125### Returns
120126
121127- `data: optional array of BetaManagedAgentsSessionEvent`
from line 1594
15881594
15891595 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
15901596
1591 - `"claude-sonnet-5" or "claude-fable-5" or "claude-opus-5" or 10 more`
1597 - `"claude-fable-5-1" or "claude-sonnet-5" or "claude-fable-5" or 11 more`
15921598
15931599 The model that will power your agent.
15941600
15951601 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
15961602
1603 - `"claude-fable-5-1"`
1604
1605 Frontier intelligence for ambitious tasks across coding, scientific discovery, and enterprise workflows
1606
15971607 - `"claude-sonnet-5"`
15981608
15991609 High-performance model for coding and agents
from line 2318
23082318
23092319 - `string`
23102320
2311 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
2321 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
23122322
23132323 - `"message-batches-2024-09-24"`
23142324
from line 2402
23922402
23932403 - `"ce-user-management-2026-07-13"`
23942404
2405 - `"mid-conversation-output-config-2026-07-01"`
2406
2407 - `"thinking-binding-controls-2026-08-01"`
2408
2409 - `"mid-conversation-system-clear-at-2026-08-21"`
2410
23952411### Returns
23962412
23972413- `BetaManagedAgentsStreamSessionThreadEvents = BetaManagedAgentsUserMessageEvent or BetaManagedAgentsUserInterruptEvent or BetaManagedAgentsUserToolConfirmationEvent or 34 more`
from line 3880
38643880
38653881 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
38663882
3867 - `"claude-sonnet-5" or "claude-fable-5" or "claude-opus-5" or 10 more`
3883 - `"claude-fable-5-1" or "claude-sonnet-5" or "claude-fable-5" or 11 more`
38683884
38693885 The model that will power your agent.
38703886
38713887 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
3888
3889 - `"claude-fable-5-1"`
3890
3891 Frontier intelligence for ambitious tasks across coding, scientific discovery, and enterprise workflows
38723892
38733893 - `"claude-sonnet-5"`
38743894
api/beta/sessions/threads/events/list Changed · +12 / -2 lines
from line 30
3030
3131 - `string`
3232
33 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
33 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
3434
3535 - `"message-batches-2024-09-24"`
3636
from line 114
114114
115115 - `"ce-user-management-2026-07-13"`
116116
117 - `"mid-conversation-output-config-2026-07-01"`
118
119 - `"thinking-binding-controls-2026-08-01"`
120
121 - `"mid-conversation-system-clear-at-2026-08-21"`
122
117123## Returns
118124
119125- `data: optional array of BetaManagedAgentsSessionEvent`
from line 1592
15861592
15871593 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
15881594
1589 - `"claude-sonnet-5" or "claude-fable-5" or "claude-opus-5" or 10 more`
1595 - `"claude-fable-5-1" or "claude-sonnet-5" or "claude-fable-5" or 11 more`
15901596
15911597 The model that will power your agent.
15921598
15931599 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
1600
1601 - `"claude-fable-5-1"`
1602
1603 Frontier intelligence for ambitious tasks across coding, scientific discovery, and enterprise workflows
15941604
15951605 - `"claude-sonnet-5"`
15961606
api/beta/sessions/threads/events/stream Changed · +12 / -2 lines
from line 28
2828
2929 - `string`
3030
31 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
31 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
3232
3333 - `"message-batches-2024-09-24"`
3434
from line 112
112112
113113 - `"ce-user-management-2026-07-13"`
114114
115 - `"mid-conversation-output-config-2026-07-01"`
116
117 - `"thinking-binding-controls-2026-08-01"`
118
119 - `"mid-conversation-system-clear-at-2026-08-21"`
120
115121## Returns
116122
117123- `BetaManagedAgentsStreamSessionThreadEvents = BetaManagedAgentsUserMessageEvent or BetaManagedAgentsUserInterruptEvent or BetaManagedAgentsUserToolConfirmationEvent or 34 more`
from line 1590
15841590
15851591 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
15861592
1587 - `"claude-sonnet-5" or "claude-fable-5" or "claude-opus-5" or 10 more`
1593 - `"claude-fable-5-1" or "claude-sonnet-5" or "claude-fable-5" or 11 more`
15881594
15891595 The model that will power your agent.
15901596
15911597 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
1598
1599 - `"claude-fable-5-1"`
1600
1601 Frontier intelligence for ambitious tasks across coding, scientific discovery, and enterprise workflows
15921602
15931603 - `"claude-sonnet-5"`
15941604
api/beta/sessions/threads/list Changed · +13 / -3 lines
from line 18
1818
1919- `page: optional string`
2020
21 Opaque pagination cursor from a previous response's next_page. Forward-only.
21 Opaque pagination cursor from a previous response's `next_page`. Forward-only.
2222
2323## Headers
2424
from line 28
2828
2929 - `string`
3030
31 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
31 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
3232
3333 - `"message-batches-2024-09-24"`
3434
from line 112
112112
113113 - `"ce-user-management-2026-07-13"`
114114
115 - `"mid-conversation-output-config-2026-07-01"`
116
117 - `"thinking-binding-controls-2026-08-01"`
118
119 - `"mid-conversation-system-clear-at-2026-08-21"`
120
115121## Returns
116122
117123- `data: optional array of BetaManagedAgentsSessionThread`
from line 158
152158
153159 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
154160
155 - `"claude-sonnet-5" or "claude-fable-5" or "claude-opus-5" or 10 more`
161 - `"claude-fable-5-1" or "claude-sonnet-5" or "claude-fable-5" or 11 more`
156162
157163 The model that will power your agent.
158164
159165 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
166
167 - `"claude-fable-5-1"`
168
169 Frontier intelligence for ambitious tasks across coding, scientific discovery, and enterprise workflows
160170
161171 - `"claude-sonnet-5"`
162172
api/beta/sessions/threads/retrieve Changed · +12 / -2 lines
from line 18
1818
1919 - `string`
2020
21 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
21 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
2222
2323 - `"message-batches-2024-09-24"`
2424
from line 102
102102
103103 - `"ce-user-management-2026-07-13"`
104104
105 - `"mid-conversation-output-config-2026-07-01"`
106
107 - `"thinking-binding-controls-2026-08-01"`
108
109 - `"mid-conversation-system-clear-at-2026-08-21"`
110
105111## Returns
106112
107113- `BetaManagedAgentsSessionThread object`
from line 148
142148
143149 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
144150
145 - `"claude-sonnet-5" or "claude-fable-5" or "claude-opus-5" or 10 more`
151 - `"claude-fable-5-1" or "claude-sonnet-5" or "claude-fable-5" or 11 more`
146152
147153 The model that will power your agent.
148154
149155 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
156
157 - `"claude-fable-5-1"`
158
159 Frontier intelligence for ambitious tasks across coding, scientific discovery, and enterprise workflows
150160
151161 - `"claude-sonnet-5"`
152162
api/beta/sessions/update Changed · +15 / -5 lines
from line 16
1616
1717 - `string`
1818
19 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
19 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
2020
2121 - `"message-batches-2024-09-24"`
2222
from line 100
100100
101101 - `"ce-user-management-2026-07-13"`
102102
103 - `"mid-conversation-output-config-2026-07-01"`
104
105 - `"thinking-binding-controls-2026-08-01"`
106
107 - `"mid-conversation-system-clear-at-2026-08-21"`
108
103109## Body parameters
104110
105111- `agent: optional BetaManagedAgentsSessionAgentUpdate`
from line 580
574580
575581 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
576582
577 - `"claude-sonnet-5" or "claude-fable-5" or "claude-opus-5" or 10 more`
583 - `"claude-fable-5-1" or "claude-sonnet-5" or "claude-fable-5" or 11 more`
578584
579585 The model that will power your agent.
580586
581587 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
582588
589 - `"claude-fable-5-1"`
590
591 Frontier intelligence for ambitious tasks across coding, scientific discovery, and enterprise workflows
592
583593 - `"claude-sonnet-5"`
584594
585595 High-performance model for coding and agents
from line 1138
11281138
11291139 - `outcome_evaluations: array of BetaManagedAgentsOutcomeEvaluationResource`
11301140
1131 Per-outcome evaluation state. One entry per define_outcome event sent to the session.
1141 Per-outcome evaluation state. One entry per `define_outcome` event sent to the session.
11321142
11331143 - `completed_at: string or null`
11341144
from line 1152
11421152
11431153 - `explanation: string or null`
11441154
1145 Grader's verdict text from the most recent evaluation. For satisfied, explains why criteria are met; for needs_revision (intermediate), what's missing; for failed, why unrecoverable.
1155 Grader's verdict text from the most recent evaluation. For `satisfied`, explains why criteria are met; for `needs_revision` (intermediate), what's missing; for `failed`, why unrecoverable.
11461156
11471157 - `iteration: number`
11481158
from line 1280
12701280
12711281 - `active_seconds: optional number`
12721282
1273 Cumulative time in seconds the session spent in running status. Excludes idle time.
1283 Cumulative time in seconds the session spent in `running` status. Excludes idle time.
12741284
12751285 format: double
12761286
api/beta/skills Changed · +63 / -9 lines
from line 14
1414
1515 - `string`
1616
17 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
17 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
1818
1919 - `"message-batches-2024-09-24"`
2020
from line 98
9898
9999 - `"ce-user-management-2026-07-13"`
100100
101 - `"mid-conversation-output-config-2026-07-01"`
102
103 - `"thinking-binding-controls-2026-08-01"`
104
105 - `"mid-conversation-system-clear-at-2026-08-21"`
106
101107### Body parameters (form-data)
102108
103109- `files: array of string`
from line 253
247253
248254 - `string`
249255
250 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
256 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
251257
252258 - `"message-batches-2024-09-24"`
253259
from line 337
331337
332338 - `"ce-user-management-2026-07-13"`
333339
340 - `"mid-conversation-output-config-2026-07-01"`
341
342 - `"thinking-binding-controls-2026-08-01"`
343
344 - `"mid-conversation-system-clear-at-2026-08-21"`
345
334346### Returns
335347
336348- `data: array of BetaSkill`
from line 472
460472
461473 - `string`
462474
463 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
475 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
464476
465477 - `"message-batches-2024-09-24"`
466478
from line 556
544556
545557 - `"ce-user-management-2026-07-13"`
546558
559 - `"mid-conversation-output-config-2026-07-01"`
560
561 - `"thinking-binding-controls-2026-08-01"`
562
563 - `"mid-conversation-system-clear-at-2026-08-21"`
564
547565### Returns
548566
549567- `BetaSkill object`
from line 678
660678
661679 - `string`
662680
663 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
681 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
664682
665683 - `"message-batches-2024-09-24"`
666684
from line 762
744762
745763 - `"ce-user-management-2026-07-13"`
746764
765 - `"mid-conversation-output-config-2026-07-01"`
766
767 - `"thinking-binding-controls-2026-08-01"`
768
769 - `"mid-conversation-system-clear-at-2026-08-21"`
770
747771### Returns
748772
749773- `BetaDeletedSkill object`
from line 941
917941
918942 - `string`
919943
920 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
944 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
921945
922946 - `"message-batches-2024-09-24"`
923947
from line 1025
10011025
10021026 - `"ce-user-management-2026-07-13"`
10031027
1028 - `"mid-conversation-output-config-2026-07-01"`
1029
1030 - `"thinking-binding-controls-2026-08-01"`
1031
1032 - `"mid-conversation-system-clear-at-2026-08-21"`
1033
10041034#### Body parameters (form-data)
10051035
10061036- `files: array of string`
from line 1140
11101140
11111141 - `string`
11121142
1113 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
1143 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
11141144
11151145 - `"message-batches-2024-09-24"`
11161146
from line 1224
11941224
11951225 - `"ce-user-management-2026-07-13"`
11961226
1227 - `"mid-conversation-output-config-2026-07-01"`
1228
1229 - `"thinking-binding-controls-2026-08-01"`
1230
1231 - `"mid-conversation-system-clear-at-2026-08-21"`
1232
11971233#### Returns
11981234
11991235- `data: array of BetaSkillVersion`
from line 1334
12981334
12991335 - `string`
13001336
1301 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
1337 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
13021338
13031339 - `"message-batches-2024-09-24"`
13041340
from line 1418
13821418
13831419 - `"ce-user-management-2026-07-13"`
13841420
1421 - `"mid-conversation-output-config-2026-07-01"`
1422
1423 - `"thinking-binding-controls-2026-08-01"`
1424
1425 - `"mid-conversation-system-clear-at-2026-08-21"`
1426
13851427#### Example
13861428
13871429```bash
from line 1460
14181460
14191461 - `string`
14201462
1421 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
1463 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
14221464
14231465 - `"message-batches-2024-09-24"`
14241466
from line 1544
15021544
15031545 - `"ce-user-management-2026-07-13"`
15041546
1547 - `"mid-conversation-output-config-2026-07-01"`
1548
1549 - `"thinking-binding-controls-2026-08-01"`
1550
1551 - `"mid-conversation-system-clear-at-2026-08-21"`
1552
15051553#### Returns
15061554
15071555- `BetaSkillVersion object`
from line 1641
15931641
15941642 - `string`
15951643
1596 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more`
1644 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
15971645
15981646 - `"message-batches-2024-09-24"`
15991647
from line 1724
16761724 - `"thinking-display-updates-2026-08-18"`
16771725
16781726 - `"ce-user-management-2026-07-13"`
1727
1728 - `"mid-conversation-output-config-2026-07-01"`
1729
1730 - `"thinking-binding-controls-2026-08-01"`
1731
1732 - `"mid-conversation-system-clear-at-2026-08-21"`
16791733
16801734#### Returns
16811735