Get Session Thread changedapi/beta/sessions/threads/retrieve
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+92added
Lines−129removed
From line
1
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits22to this page, all time
# Get Session Thread ## Path parameters ## Headers ## Returns ## Example ### Response (200) ## Get Session Thread ### Path Parameters ### Header Parameters ### Returns ### Example #### Response
The whole hunk
from line 1, old and new numbered
/
from line 1
1---
2title: Get Session Thread
3url: https://platform.claude.com/docs/en/api/beta/sessions/threads/retrieve
4---
1# Get Session Thread
52
6## Get Session Thread
3**GET** `/v1/sessions/{session_id}/threads/{thread_id}`
74
8**get** `/v1/sessions/{session_id}/threads/{thread_id}`
9
105Get Session Thread
116
12### Path Parameters
7## Path parameters
138
149- `session_id: string`
1510
1611- `thread_id: string`
1712
18### Header Parameters
13## Headers
1914
2015- `"anthropic-beta": optional array of AnthropicBeta`
2116
from line 88
9388
9489 - `"mid-conversation-tool-changes-2026-07-01"`
9590
96### Returns
91## Returns
9792
98- `BetaManagedAgentsSessionThread object { id, agent, archived_at, 8 more }`
93- `BetaManagedAgentsSessionThread object`
9994
10095 An execution thread within a `session`. Each session has one primary thread plus zero or more child threads spawned by the coordinator.
10196
from line 102
107102
108103 A session-resolved multiagent roster entry.
109104
110 - `BetaManagedAgentsSessionThreadAgent object { id, description, mcp_servers, 7 more }`
105 - `BetaManagedAgentsSessionThreadAgent object`
111106
112107 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`.
113108
from line 116
121116
122117 - `type: "url"`
123118
124 - `"url"`
125
126119 - `url: string`
127120
128121 - `model: BetaManagedAgentsModelConfig`
from line 192
199192
200193 How hard Claude works on each turn. Sets `output_config.effort` on every Messages call the session makes.
201194
202 - `BetaManagedAgentsEffortLow object { type }`
195 - `BetaManagedAgentsEffortLow object`
203196
204197 Low effort. Favors latency over reasoning depth.
205198
206199 - `type: "low"`
207200
208 - `"low"`
201 - `BetaManagedAgentsEffortMedium object`
209202
210 - `BetaManagedAgentsEffortMedium object { type }`
211
212203 Medium effort. Balances latency and reasoning depth.
213204
214205 - `type: "medium"`
215206
216 - `"medium"`
207 - `BetaManagedAgentsEffortHigh object`
217208
218 - `BetaManagedAgentsEffortHigh object { type }`
219
220209 High effort. Favors reasoning depth.
221210
222211 - `type: "high"`
223212
224 - `"high"`
213 - `BetaManagedAgentsEffortXhigh object`
225214
226 - `BetaManagedAgentsEffortXhigh object { type }`
227
228215 Extra-high effort. Not all models accept this level.
229216
230217 - `type: "xhigh"`
231218
232 - `"xhigh"`
219 - `BetaManagedAgentsEffortMax object`
233220
234 - `BetaManagedAgentsEffortMax object { type }`
235
236221 Maximum effort. Favors reasoning depth over latency.
237222
238223 - `type: "max"`
239224
240 - `"max"`
241
242225 - `inference_geo: optional string`
243226
244227 Geographic region for model inference. When unset, requests fall through to the workspace's default_inference_geo.
from line 238
255238
256239 - `skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill`
257240
258 - `BetaManagedAgentsAnthropicSkill object { skill_id, type, version }`
241 - `BetaManagedAgentsAnthropicSkill object`
259242
260243 A resolved Anthropic-managed skill.
261244
from line 246
263246
264247 - `type: "anthropic"`
265248
266 - `"anthropic"`
267
268249 - `version: string`
269250
270 - `BetaManagedAgentsCustomSkill object { skill_id, type, version }`
251 - `BetaManagedAgentsCustomSkill object`
271252
272253 A resolved user-created custom skill.
273254
from line 256
275256
276257 - `type: "custom"`
277258
278 - `"custom"`
279
280259 - `version: string`
281260
282261 - `system: string or null`
from line 262
283262
284263 - `tools: array of BetaManagedAgentsAgentToolset20260401 or BetaManagedAgentsMCPToolset or BetaManagedAgentsCustomTool`
285264
286 - `BetaManagedAgentsAgentToolset20260401 object { configs, default_config, type }`
265 - `BetaManagedAgentsAgentToolset20260401 object`
287266
288267 - `configs: array of BetaManagedAgentsAgentToolConfig`
289268
290 - `BetaManagedAgentsBashToolConfig object { enabled, name, permission_policy, type }`
269 - `BetaManagedAgentsBashToolConfig object`
291270
292271 Configuration for the bash tool.
293272
from line 274
295274
296275 - `name: "bash"`
297276
298 - `"bash"`
299
300277 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
301278
302279 Permission policy for tool execution.
303280
304 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
281 - `BetaManagedAgentsAlwaysAllowPolicy object`
305282
306283 Tool calls are automatically approved without user confirmation.
307284
308285 - `type: "always_allow"`
309286
310 - `"always_allow"`
287 - `BetaManagedAgentsAlwaysAskPolicy object`
311288
312 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
313
314289 Tool calls require user confirmation before execution.
315290
316291 - `type: "always_ask"`
317292
318 - `"always_ask"`
319
320293 - `type: "bash"`
321294
322 - `"bash"`
295 - `BetaManagedAgentsEditToolConfig object`
323296
324 - `BetaManagedAgentsEditToolConfig object { enabled, name, permission_policy, type }`
325
326297 Configuration for the edit tool.
327298
328299 - `enabled: boolean`
from line 300
329300
330301 - `name: "edit"`
331302
332 - `"edit"`
333
334303 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
335304
336305 Permission policy for tool execution.
337306
338 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
307 - `BetaManagedAgentsAlwaysAllowPolicy object`
339308
340309 Tool calls are automatically approved without user confirmation.
341310
342 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
311 - `BetaManagedAgentsAlwaysAskPolicy object`
343312
344313 Tool calls require user confirmation before execution.
345314
346315 - `type: "edit"`
347316
348 - `"edit"`
317 - `BetaManagedAgentsReadToolConfig object`
349318
350 - `BetaManagedAgentsReadToolConfig object { enabled, name, permission_policy, type }`
351
352319 Configuration for the read tool.
353320
354321 - `enabled: boolean`
from line 322
355322
356323 - `name: "read"`
357324
358 - `"read"`
359
360325 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
361326
362327 Permission policy for tool execution.
363328
364 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
329 - `BetaManagedAgentsAlwaysAllowPolicy object`
365330
366331 Tool calls are automatically approved without user confirmation.
367332
368 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
333 - `BetaManagedAgentsAlwaysAskPolicy object`
369334
370335 Tool calls require user confirmation before execution.
371336
372337 - `type: "read"`
373338
374 - `"read"`
339 - `BetaManagedAgentsWriteToolConfig object`
375340
376 - `BetaManagedAgentsWriteToolConfig object { enabled, name, permission_policy, type }`
377
378341 Configuration for the write tool.
379342
380343 - `enabled: boolean`
from line 344
381344
382345 - `name: "write"`
383346
384 - `"write"`
385
386347 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
387348
388349 Permission policy for tool execution.
389350
390 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
351 - `BetaManagedAgentsAlwaysAllowPolicy object`
391352
392353 Tool calls are automatically approved without user confirmation.
393354
394 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
355 - `BetaManagedAgentsAlwaysAskPolicy object`
395356
396357 Tool calls require user confirmation before execution.
397358
398359 - `type: "write"`
399360
400 - `"write"`
361 - `BetaManagedAgentsGlobToolConfig object`
401362
402 - `BetaManagedAgentsGlobToolConfig object { enabled, name, permission_policy, type }`
403
404363 Configuration for the glob tool.
405364
406365 - `enabled: boolean`
from line 366
407366
408367 - `name: "glob"`
409368
410 - `"glob"`
411
412369 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
413370
414371 Permission policy for tool execution.
415372
416 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
373 - `BetaManagedAgentsAlwaysAllowPolicy object`
417374
418375 Tool calls are automatically approved without user confirmation.
419376
420 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
377 - `BetaManagedAgentsAlwaysAskPolicy object`
421378
422379 Tool calls require user confirmation before execution.
423380
424381 - `type: "glob"`
425382
426 - `"glob"`
383 - `BetaManagedAgentsGrepToolConfig object`
427384
428 - `BetaManagedAgentsGrepToolConfig object { enabled, name, permission_policy, type }`
429
430385 Configuration for the grep tool.
431386
432387 - `enabled: boolean`
from line 388
433388
434389 - `name: "grep"`
435390
436 - `"grep"`
437
438391 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
439392
440393 Permission policy for tool execution.
441394
442 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
395 - `BetaManagedAgentsAlwaysAllowPolicy object`
443396
444397 Tool calls are automatically approved without user confirmation.
445398
446 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
399 - `BetaManagedAgentsAlwaysAskPolicy object`
447400
448401 Tool calls require user confirmation before execution.
449402
450403 - `type: "grep"`
451404
452 - `"grep"`
405 - `BetaManagedAgentsWebFetchToolConfig object`
453406
454 - `BetaManagedAgentsWebFetchToolConfig object { enabled, name, permission_policy, 4 more }`
455
456407 Configuration for the web_fetch tool.
457408
458409 - `enabled: boolean`
from line 410
459410
460411 - `name: "web_fetch"`
461412
462 - `"web_fetch"`
463
464413 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
465414
466415 Permission policy for tool execution.
467416
468 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
417 - `BetaManagedAgentsAlwaysAllowPolicy object`
469418
470419 Tool calls are automatically approved without user confirmation.
471420
472 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
421 - `BetaManagedAgentsAlwaysAskPolicy object`
473422
474423 Tool calls require user confirmation before execution.
475424
476425 - `type: "web_fetch"`
477426
478 - `"web_fetch"`
479
480427 - `allowed_domains: optional array of string`
481428
482429 - `blocked_domains: optional array of string`
from line 430
483430
484431 - `max_content_tokens: optional number or null`
485432
486 - `BetaManagedAgentsWebSearchToolConfig object { enabled, name, permission_policy, 4 more }`
433 format: int32
487434
435 - `BetaManagedAgentsWebSearchToolConfig object`
436
488437 Configuration for the web_search tool.
489438
490439 - `enabled: boolean`
from line 440
491440
492441 - `name: "web_search"`
493442
494 - `"web_search"`
495
496443 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
497444
498445 Permission policy for tool execution.
499446
500 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
447 - `BetaManagedAgentsAlwaysAllowPolicy object`
501448
502449 Tool calls are automatically approved without user confirmation.
503450
504 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
451 - `BetaManagedAgentsAlwaysAskPolicy object`
505452
506453 Tool calls require user confirmation before execution.
507454
508455 - `type: "web_search"`
509456
510 - `"web_search"`
511
512457 - `allowed_domains: optional array of string`
513458
514459 - `blocked_domains: optional array of string`
from line 466
521466
522467 Location precision. Only "approximate" is supported.
523468
524 - `"approximate"`
525
526469 - `city: optional string or null`
527470
528471 City name.
529472
473 minLength: 1, maxLength: 255
474
530475 - `country: optional string or null`
531476
532477 Two-letter ISO 3166-1 country code, uppercase.
from line 480
535480
536481 Region or state name.
537482
483 minLength: 1, maxLength: 255
484
538485 - `timezone: optional string or null`
539486
540487 IANA timezone identifier, e.g. "America/Los_Angeles".
541488
489 minLength: 1, maxLength: 255
490
542491 - `default_config: BetaManagedAgentsAgentToolsetDefaultConfig`
543492
544493 Resolved default configuration for agent tools.
from line 498
549498
550499 Permission policy for tool execution.
551500
552 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
501 - `BetaManagedAgentsAlwaysAllowPolicy object`
553502
554503 Tool calls are automatically approved without user confirmation.
555504
556 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
505 - `BetaManagedAgentsAlwaysAskPolicy object`
557506
558507 Tool calls require user confirmation before execution.
559508
560509 - `type: "agent_toolset_20260401"`
561510
562 - `"agent_toolset_20260401"`
511 - `BetaManagedAgentsMCPToolset object`
563512
564 - `BetaManagedAgentsMCPToolset object { configs, default_config, mcp_server_name, type }`
565
566513 - `configs: array of BetaManagedAgentsMCPToolConfig`
567514
568515 - `enabled: boolean`
from line 520
573520
574521 Permission policy for tool execution.
575522
576 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
523 - `BetaManagedAgentsAlwaysAllowPolicy object`
577524
578525 Tool calls are automatically approved without user confirmation.
579526
580 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
527 - `BetaManagedAgentsAlwaysAskPolicy object`
581528
582529 Tool calls require user confirmation before execution.
583530
from line 538
591538
592539 Permission policy for tool execution.
593540
594 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
541 - `BetaManagedAgentsAlwaysAllowPolicy object`
595542
596543 Tool calls are automatically approved without user confirmation.
597544
598 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
545 - `BetaManagedAgentsAlwaysAskPolicy object`
599546
600547 Tool calls require user confirmation before execution.
601548
from line 550
603550
604551 - `type: "mcp_toolset"`
605552
606 - `"mcp_toolset"`
553 - `BetaManagedAgentsCustomTool object`
607554
608 - `BetaManagedAgentsCustomTool object { description, input_schema, name, type }`
609
610555 A custom tool as returned in API responses.
611556
612557 - `description: string`
from line 562
617562
618563 - `type: "object"`
619564
620 - `"object"`
621
622565 - `properties: optional map[unknown] or null`
623566
624567 - `required: optional array of string or null`
from line 570
627570
628571 - `type: "custom"`
629572
630 - `"custom"`
631
632573 - `type: "agent"`
633574
634 - `"agent"`
635
636575 - `version: number`
637576
638 - `BetaManagedAgentsAdvisor object { model, type }`
577 format: int32
639578
579 - `BetaManagedAgentsAdvisor object`
580
640581 Platform advisor roster entry: a model the session's primary thread may consult mid-turn.
641582
642583 - `model: string`
from line 586
645586
646587 - `type: "advisor"`
647588
648 - `"advisor"`
649
650589 - `archived_at: string or null`
651590
652591 A timestamp in RFC 3339 format
653592
593 format: date-time
594
654595 - `created_at: string`
655596
656597 A timestamp in RFC 3339 format
657598
599 format: date-time
600
658601 - `parent_thread_id: string or null`
659602
660603 Parent thread that spawned this thread. Null for the primary thread.
from line 614
671614
672615 Cumulative time in seconds the thread spent actively running. Excludes idle time.
673616
617 format: double
618
674619 - `duration_seconds: optional number`
675620
676621 Elapsed time since thread creation in seconds. For archived threads, frozen at the final update.
677622
623 format: double
624
678625 - `startup_seconds: optional number`
679626
680627 Time in seconds for the thread to begin running. Zero for child threads, which start immediately.
681628
629 format: double
630
682631 - `status: BetaManagedAgentsSessionThreadStatus`
683632
684633 SessionThreadStatus enum
from line 642
693642
694643 - `type: "session_thread"`
695644
696 - `"session_thread"`
697
698645 - `updated_at: string`
699646
700647 A timestamp in RFC 3339 format
701648
649 format: date-time
650
702651 - `usage: BetaManagedAgentsSessionThreadUsage or null`
703652
704653 Cumulative token usage for a session thread across all turns.
from line 656
707656
708657 Cumulative time in seconds this thread spent in running status. Equal to `stats.active_seconds`; surfaced here so a thread's usage carries every quantity its cost is priced on.
709658
659 format: double
660
710661 - `cache_creation: optional BetaManagedAgentsCacheCreationUsage`
711662
712663 Prompt-cache creation token usage broken down by cache lifetime.
from line 666
715666
716667 Tokens used to create 1-hour ephemeral cache entries.
717668
669 format: int32
670
718671 - `ephemeral_5m_input_tokens: optional number`
719672
720673 Tokens used to create 5-minute ephemeral cache entries.
721674
675 format: int32
676
722677 - `cache_read_input_tokens: optional number`
723678
724679 Total tokens read from prompt cache.
725680
681 format: int32
682
726683 - `input_tokens: optional number`
727684
728685 Total input tokens consumed across all turns.
729686
687 format: int32
688
730689 - `list_cost: optional BetaMonetaryAmount or null`
731690
732691 A monetary amount in a specific currency.
from line 698
739698
740699 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.
741700
742 - `"USD"`
743
744701 - `output_tokens: optional number`
745702
746703 Total output tokens generated across all turns.
747704
705 format: int32
706
748707 - `server_tool_use: optional BetaManagedAgentsServerToolUsage or null`
749708
750709 Cumulative count of server-executed tool invocations, broken down by tool.
from line 712
753712
754713 Number of server-executed web fetch requests.
755714
715 format: int32
716
756717 - `web_search_requests: optional number`
757718
758719 Number of server-executed web search requests.
759720
760### Example
721 format: int32
761722
762```http
723## Example
724
725```bash
763726curl https://api.anthropic.com/v1/sessions/$SESSION_ID/threads/$THREAD_ID \
764727 -H 'anthropic-version: 2023-06-01' \
765728 -H 'anthropic-beta: managed-agents-2026-04-01' \
from line 729
766729 -H "X-Api-Key: $ANTHROPIC_API_KEY"
767730```
768731
769#### Response
732### Response (200)
770733
771734```json
772735{
No line in this hunk matches that.