List Session Threads changedapi/beta/sessions/threads/list
Nearest release: v2.1.245, published an hour after this site recorded the change. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.
Recorded here
Lines+93added
Lines−128removed
From line
1
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits23to this page, all time
# List Session Threads ## Path parameters ## Query parameters ## Headers ## Returns ## Example ### Response (200) ## List Session Threads ### Path Parameters ### Query Parameters ### Header Parameters ### Returns ### Example #### Response
The whole hunk
from line 1, old and new numbered
/
from line 1
1---
2title: List Session Threads
3url: https://platform.claude.com/docs/en/api/beta/sessions/threads/list
4---
1# List Session Threads
52
6## List Session Threads
3**GET** `/v1/sessions/{session_id}/threads`
74
8**get** `/v1/sessions/{session_id}/threads`
9
105List Session Threads
116
12### Path Parameters
7## Path parameters
138
149- `session_id: string`
1510
16### Query Parameters
11## Query parameters
1712
1813- `limit: optional number`
1914
2015 Maximum results per page. Defaults to 1000.
2116
17 format: int32
18
2219- `page: optional string`
2320
2421 Opaque pagination cursor from a previous response's next_page. Forward-only.
2522
26### Header Parameters
23## Headers
2724
2825- `"anthropic-beta": optional array of AnthropicBeta`
2926
from line 98
10198
10299 - `"mid-conversation-tool-changes-2026-07-01"`
103100
104### Returns
101## Returns
105102
106103- `data: optional array of BetaManagedAgentsSessionThread`
107104
from line 112
115112
116113 A session-resolved multiagent roster entry.
117114
118 - `BetaManagedAgentsSessionThreadAgent object { id, description, mcp_servers, 7 more }`
115 - `BetaManagedAgentsSessionThreadAgent object`
119116
120117 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`.
121118
from line 126
129126
130127 - `type: "url"`
131128
132 - `"url"`
133
134129 - `url: string`
135130
136131 - `model: BetaManagedAgentsModelConfig`
from line 202
207202
208203 How hard Claude works on each turn. Sets `output_config.effort` on every Messages call the session makes.
209204
210 - `BetaManagedAgentsEffortLow object { type }`
205 - `BetaManagedAgentsEffortLow object`
211206
212207 Low effort. Favors latency over reasoning depth.
213208
214209 - `type: "low"`
215210
216 - `"low"`
211 - `BetaManagedAgentsEffortMedium object`
217212
218 - `BetaManagedAgentsEffortMedium object { type }`
219
220213 Medium effort. Balances latency and reasoning depth.
221214
222215 - `type: "medium"`
223216
224 - `"medium"`
217 - `BetaManagedAgentsEffortHigh object`
225218
226 - `BetaManagedAgentsEffortHigh object { type }`
227
228219 High effort. Favors reasoning depth.
229220
230221 - `type: "high"`
231222
232 - `"high"`
223 - `BetaManagedAgentsEffortXhigh object`
233224
234 - `BetaManagedAgentsEffortXhigh object { type }`
235
236225 Extra-high effort. Not all models accept this level.
237226
238227 - `type: "xhigh"`
239228
240 - `"xhigh"`
229 - `BetaManagedAgentsEffortMax object`
241230
242 - `BetaManagedAgentsEffortMax object { type }`
243
244231 Maximum effort. Favors reasoning depth over latency.
245232
246233 - `type: "max"`
247234
248 - `"max"`
249
250235 - `inference_geo: optional string`
251236
252237 Geographic region for model inference. When unset, requests fall through to the workspace's default_inference_geo.
from line 248
263248
264249 - `skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill`
265250
266 - `BetaManagedAgentsAnthropicSkill object { skill_id, type, version }`
251 - `BetaManagedAgentsAnthropicSkill object`
267252
268253 A resolved Anthropic-managed skill.
269254
from line 256
271256
272257 - `type: "anthropic"`
273258
274 - `"anthropic"`
275
276259 - `version: string`
277260
278 - `BetaManagedAgentsCustomSkill object { skill_id, type, version }`
261 - `BetaManagedAgentsCustomSkill object`
279262
280263 A resolved user-created custom skill.
281264
from line 266
283266
284267 - `type: "custom"`
285268
286 - `"custom"`
287
288269 - `version: string`
289270
290271 - `system: string or null`
from line 272
291272
292273 - `tools: array of BetaManagedAgentsAgentToolset20260401 or BetaManagedAgentsMCPToolset or BetaManagedAgentsCustomTool`
293274
294 - `BetaManagedAgentsAgentToolset20260401 object { configs, default_config, type }`
275 - `BetaManagedAgentsAgentToolset20260401 object`
295276
296277 - `configs: array of BetaManagedAgentsAgentToolConfig`
297278
298 - `BetaManagedAgentsBashToolConfig object { enabled, name, permission_policy, type }`
279 - `BetaManagedAgentsBashToolConfig object`
299280
300281 Configuration for the bash tool.
301282
from line 284
303284
304285 - `name: "bash"`
305286
306 - `"bash"`
307
308287 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
309288
310289 Permission policy for tool execution.
311290
312 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
291 - `BetaManagedAgentsAlwaysAllowPolicy object`
313292
314293 Tool calls are automatically approved without user confirmation.
315294
316295 - `type: "always_allow"`
317296
318 - `"always_allow"`
297 - `BetaManagedAgentsAlwaysAskPolicy object`
319298
320 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
321
322299 Tool calls require user confirmation before execution.
323300
324301 - `type: "always_ask"`
325302
326 - `"always_ask"`
327
328303 - `type: "bash"`
329304
330 - `"bash"`
305 - `BetaManagedAgentsEditToolConfig object`
331306
332 - `BetaManagedAgentsEditToolConfig object { enabled, name, permission_policy, type }`
333
334307 Configuration for the edit tool.
335308
336309 - `enabled: boolean`
from line 310
337310
338311 - `name: "edit"`
339312
340 - `"edit"`
341
342313 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
343314
344315 Permission policy for tool execution.
345316
346 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
317 - `BetaManagedAgentsAlwaysAllowPolicy object`
347318
348319 Tool calls are automatically approved without user confirmation.
349320
350 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
321 - `BetaManagedAgentsAlwaysAskPolicy object`
351322
352323 Tool calls require user confirmation before execution.
353324
354325 - `type: "edit"`
355326
356 - `"edit"`
327 - `BetaManagedAgentsReadToolConfig object`
357328
358 - `BetaManagedAgentsReadToolConfig object { enabled, name, permission_policy, type }`
359
360329 Configuration for the read tool.
361330
362331 - `enabled: boolean`
from line 332
363332
364333 - `name: "read"`
365334
366 - `"read"`
367
368335 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
369336
370337 Permission policy for tool execution.
371338
372 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
339 - `BetaManagedAgentsAlwaysAllowPolicy object`
373340
374341 Tool calls are automatically approved without user confirmation.
375342
376 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
343 - `BetaManagedAgentsAlwaysAskPolicy object`
377344
378345 Tool calls require user confirmation before execution.
379346
380347 - `type: "read"`
381348
382 - `"read"`
349 - `BetaManagedAgentsWriteToolConfig object`
383350
384 - `BetaManagedAgentsWriteToolConfig object { enabled, name, permission_policy, type }`
385
386351 Configuration for the write tool.
387352
388353 - `enabled: boolean`
from line 354
389354
390355 - `name: "write"`
391356
392 - `"write"`
393
394357 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
395358
396359 Permission policy for tool execution.
397360
398 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
361 - `BetaManagedAgentsAlwaysAllowPolicy object`
399362
400363 Tool calls are automatically approved without user confirmation.
401364
402 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
365 - `BetaManagedAgentsAlwaysAskPolicy object`
403366
404367 Tool calls require user confirmation before execution.
405368
406369 - `type: "write"`
407370
408 - `"write"`
371 - `BetaManagedAgentsGlobToolConfig object`
409372
410 - `BetaManagedAgentsGlobToolConfig object { enabled, name, permission_policy, type }`
411
412373 Configuration for the glob tool.
413374
414375 - `enabled: boolean`
from line 376
415376
416377 - `name: "glob"`
417378
418 - `"glob"`
419
420379 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
421380
422381 Permission policy for tool execution.
423382
424 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
383 - `BetaManagedAgentsAlwaysAllowPolicy object`
425384
426385 Tool calls are automatically approved without user confirmation.
427386
428 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
387 - `BetaManagedAgentsAlwaysAskPolicy object`
429388
430389 Tool calls require user confirmation before execution.
431390
432391 - `type: "glob"`
433392
434 - `"glob"`
393 - `BetaManagedAgentsGrepToolConfig object`
435394
436 - `BetaManagedAgentsGrepToolConfig object { enabled, name, permission_policy, type }`
437
438395 Configuration for the grep tool.
439396
440397 - `enabled: boolean`
from line 398
441398
442399 - `name: "grep"`
443400
444 - `"grep"`
445
446401 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
447402
448403 Permission policy for tool execution.
449404
450 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
405 - `BetaManagedAgentsAlwaysAllowPolicy object`
451406
452407 Tool calls are automatically approved without user confirmation.
453408
454 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
409 - `BetaManagedAgentsAlwaysAskPolicy object`
455410
456411 Tool calls require user confirmation before execution.
457412
458413 - `type: "grep"`
459414
460 - `"grep"`
415 - `BetaManagedAgentsWebFetchToolConfig object`
461416
462 - `BetaManagedAgentsWebFetchToolConfig object { enabled, name, permission_policy, 4 more }`
463
464417 Configuration for the web_fetch tool.
465418
466419 - `enabled: boolean`
from line 420
467420
468421 - `name: "web_fetch"`
469422
470 - `"web_fetch"`
471
472423 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
473424
474425 Permission policy for tool execution.
475426
476 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
427 - `BetaManagedAgentsAlwaysAllowPolicy object`
477428
478429 Tool calls are automatically approved without user confirmation.
479430
480 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
431 - `BetaManagedAgentsAlwaysAskPolicy object`
481432
482433 Tool calls require user confirmation before execution.
483434
484435 - `type: "web_fetch"`
485436
486 - `"web_fetch"`
487
488437 - `allowed_domains: optional array of string`
489438
490439 - `blocked_domains: optional array of string`
from line 440
491440
492441 - `max_content_tokens: optional number or null`
493442
494 - `BetaManagedAgentsWebSearchToolConfig object { enabled, name, permission_policy, 4 more }`
443 format: int32
495444
445 - `BetaManagedAgentsWebSearchToolConfig object`
446
496447 Configuration for the web_search tool.
497448
498449 - `enabled: boolean`
from line 450
499450
500451 - `name: "web_search"`
501452
502 - `"web_search"`
503
504453 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
505454
506455 Permission policy for tool execution.
507456
508 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
457 - `BetaManagedAgentsAlwaysAllowPolicy object`
509458
510459 Tool calls are automatically approved without user confirmation.
511460
512 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
461 - `BetaManagedAgentsAlwaysAskPolicy object`
513462
514463 Tool calls require user confirmation before execution.
515464
516465 - `type: "web_search"`
517466
518 - `"web_search"`
519
520467 - `allowed_domains: optional array of string`
521468
522469 - `blocked_domains: optional array of string`
from line 476
529476
530477 Location precision. Only "approximate" is supported.
531478
532 - `"approximate"`
533
534479 - `city: optional string or null`
535480
536481 City name.
537482
483 minLength: 1, maxLength: 255
484
538485 - `country: optional string or null`
539486
540487 Two-letter ISO 3166-1 country code, uppercase.
from line 490
543490
544491 Region or state name.
545492
493 minLength: 1, maxLength: 255
494
546495 - `timezone: optional string or null`
547496
548497 IANA timezone identifier, e.g. "America/Los_Angeles".
549498
499 minLength: 1, maxLength: 255
500
550501 - `default_config: BetaManagedAgentsAgentToolsetDefaultConfig`
551502
552503 Resolved default configuration for agent tools.
from line 508
557508
558509 Permission policy for tool execution.
559510
560 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
511 - `BetaManagedAgentsAlwaysAllowPolicy object`
561512
562513 Tool calls are automatically approved without user confirmation.
563514
564 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
515 - `BetaManagedAgentsAlwaysAskPolicy object`
565516
566517 Tool calls require user confirmation before execution.
567518
568519 - `type: "agent_toolset_20260401"`
569520
570 - `"agent_toolset_20260401"`
521 - `BetaManagedAgentsMCPToolset object`
571522
572 - `BetaManagedAgentsMCPToolset object { configs, default_config, mcp_server_name, type }`
573
574523 - `configs: array of BetaManagedAgentsMCPToolConfig`
575524
576525 - `enabled: boolean`
from line 530
581530
582531 Permission policy for tool execution.
583532
584 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
533 - `BetaManagedAgentsAlwaysAllowPolicy object`
585534
586535 Tool calls are automatically approved without user confirmation.
587536
588 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
537 - `BetaManagedAgentsAlwaysAskPolicy object`
589538
590539 Tool calls require user confirmation before execution.
591540
from line 548
599548
600549 Permission policy for tool execution.
601550
602 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
551 - `BetaManagedAgentsAlwaysAllowPolicy object`
603552
604553 Tool calls are automatically approved without user confirmation.
605554
606 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
555 - `BetaManagedAgentsAlwaysAskPolicy object`
607556
608557 Tool calls require user confirmation before execution.
609558
from line 560
611560
612561 - `type: "mcp_toolset"`
613562
614 - `"mcp_toolset"`
563 - `BetaManagedAgentsCustomTool object`
615564
616 - `BetaManagedAgentsCustomTool object { description, input_schema, name, type }`
617
618565 A custom tool as returned in API responses.
619566
620567 - `description: string`
from line 572
625572
626573 - `type: "object"`
627574
628 - `"object"`
629
630575 - `properties: optional map[unknown] or null`
631576
632577 - `required: optional array of string or null`
from line 580
635580
636581 - `type: "custom"`
637582
638 - `"custom"`
639
640583 - `type: "agent"`
641584
642 - `"agent"`
643
644585 - `version: number`
645586
646 - `BetaManagedAgentsAdvisor object { model, type }`
587 format: int32
647588
589 - `BetaManagedAgentsAdvisor object`
590
648591 Platform advisor roster entry: a model the session's primary thread may consult mid-turn.
649592
650593 - `model: string`
from line 596
653596
654597 - `type: "advisor"`
655598
656 - `"advisor"`
657
658599 - `archived_at: string or null`
659600
660601 A timestamp in RFC 3339 format
661602
603 format: date-time
604
662605 - `created_at: string`
663606
664607 A timestamp in RFC 3339 format
665608
609 format: date-time
610
666611 - `parent_thread_id: string or null`
667612
668613 Parent thread that spawned this thread. Null for the primary thread.
from line 624
679624
680625 Cumulative time in seconds the thread spent actively running. Excludes idle time.
681626
627 format: double
628
682629 - `duration_seconds: optional number`
683630
684631 Elapsed time since thread creation in seconds. For archived threads, frozen at the final update.
685632
633 format: double
634
686635 - `startup_seconds: optional number`
687636
688637 Time in seconds for the thread to begin running. Zero for child threads, which start immediately.
689638
639 format: double
640
690641 - `status: BetaManagedAgentsSessionThreadStatus`
691642
692643 SessionThreadStatus enum
from line 652
701652
702653 - `type: "session_thread"`
703654
704 - `"session_thread"`
705
706655 - `updated_at: string`
707656
708657 A timestamp in RFC 3339 format
709658
659 format: date-time
660
710661 - `usage: BetaManagedAgentsSessionThreadUsage or null`
711662
712663 Cumulative token usage for a session thread across all turns.
from line 666
715666
716667 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.
717668
669 format: double
670
718671 - `cache_creation: optional BetaManagedAgentsCacheCreationUsage`
719672
720673 Prompt-cache creation token usage broken down by cache lifetime.
from line 676
723676
724677 Tokens used to create 1-hour ephemeral cache entries.
725678
679 format: int32
680
726681 - `ephemeral_5m_input_tokens: optional number`
727682
728683 Tokens used to create 5-minute ephemeral cache entries.
729684
685 format: int32
686
730687 - `cache_read_input_tokens: optional number`
731688
732689 Total tokens read from prompt cache.
733690
691 format: int32
692
734693 - `input_tokens: optional number`
735694
736695 Total input tokens consumed across all turns.
737696
697 format: int32
698
738699 - `list_cost: optional BetaMonetaryAmount or null`
739700
740701 A monetary amount in a specific currency.
from line 708
747708
748709 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.
749710
750 - `"USD"`
751
752711 - `output_tokens: optional number`
753712
754713 Total output tokens generated across all turns.
755714
715 format: int32
716
756717 - `server_tool_use: optional BetaManagedAgentsServerToolUsage or null`
757718
758719 Cumulative count of server-executed tool invocations, broken down by tool.
from line 722
761722
762723 Number of server-executed web fetch requests.
763724
725 format: int32
726
764727 - `web_search_requests: optional number`
765728
766729 Number of server-executed web search requests.
767730
731 format: int32
732
768733- `next_page: optional string or null`
769734
770735 Opaque cursor for the next page. Null when no more results.
771736
772### Example
737## Example
773738
774```http
739```bash
775740curl https://api.anthropic.com/v1/sessions/$SESSION_ID/threads \
776741 -H 'anthropic-version: 2023-06-01' \
777742 -H 'anthropic-beta: managed-agents-2026-04-01' \
from line 743
778743 -H "X-Api-Key: $ANTHROPIC_API_KEY"
779744```
780745
781#### Response
746### Response (200)
782747
783748```json
784749{
No line in this hunk matches that.