List Session Threads changedapi/beta/sessions/threads/list
Nearest release: v2.1.268, published under 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+366added
Lines−311removed
From line
1
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits26to this page, all time
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---
5
16# List Session Threads
27
38**GET** `/v1/sessions/{session_id}/threads`
from line 33
2833
2934 - `string`
3035
31 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
36 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
3237
3338 - `"message-batches-2024-09-24"`
3439
from line 81
7681
7782 - `"user-profiles-2026-08-18"`
7883
84 - `"user-profiles-2026-09-04"`
85
7986 - `"advisor-tool-2026-03-01"`
8087
8188 - `"managed-agents-2026-04-01"`
from line 125
118125
119126 - `"mid-conversation-system-clear-at-2026-08-21"`
120127
128- `"anthropic-workspace-id": optional string`
129
121130## Returns
122131
123132- `data: optional array of BetaManagedAgentsSessionThread`
from line 133
124133
125134 Threads in the session, primary first then children in spawn order.
126135
136 - `type: "session_thread"`
137
127138 - `id: string`
128139
129140 Unique identifier for this thread.
from line 147
136147
137148 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`.
138149
150 - `type: "agent"`
151
139152 - `id: string`
140153
141154 - `description: string or null`
from line 155
142155
143156 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
144157
145 - `name: string`
146
147158 - `type: "url"`
148159
160 - `name: string`
161
149162 - `url: string`
150163
151164 - `model: BetaManagedAgentsModelConfig`
from line 289
276289
277290 A resolved Anthropic-managed skill.
278291
279 - `skill_id: string`
280
281292 - `type: "anthropic"`
282293
294 - `skill_id: string`
295
283296 - `version: string`
284297
285298 - `BetaManagedAgentsCustomSkill object`
from line 299
286299
287300 A resolved user-created custom skill.
288301
289 - `skill_id: string`
290
291302 - `type: "custom"`
292303
304 - `skill_id: string`
305
293306 - `version: string`
294307
295308 - `system: string or null`
from line 311
298311
299312 - `BetaManagedAgentsAgentToolset20260401 object`
300313
314 - `type: "agent_toolset_20260401"`
315
301316 - `configs: array of BetaManagedAgentsAgentToolConfig`
302317
303318 - `BetaManagedAgentsBashToolConfig object`
from line 319
304319
305320 Configuration for the bash tool.
306321
322 - `type: "bash"`
323
307324 - `enabled: boolean`
308325
309326 - `name: "bash"`
310327
311 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
328 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
312329
313330 Permission policy for tool execution.
314331
from line 341
324341
325342 - `type: "always_ask"`
326343
327 - `type: "bash"`
344 - `BetaManagedAgentsAutoPolicy object`
328345
346 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
347
348 - `type: "auto"`
349
329350 - `BetaManagedAgentsEditToolConfig object`
330351
331352 Configuration for the edit tool.
332353
354 - `type: "edit"`
355
333356 - `enabled: boolean`
334357
335358 - `name: "edit"`
336359
337 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
360 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
338361
339362 Permission policy for tool execution.
340363
from line 369
346369
347370 Tool calls require user confirmation before execution.
348371
349 - `type: "edit"`
372 - `BetaManagedAgentsAutoPolicy object`
350373
374 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
375
351376 - `BetaManagedAgentsReadToolConfig object`
352377
353378 Configuration for the read tool.
354379
380 - `type: "read"`
381
355382 - `enabled: boolean`
356383
357384 - `name: "read"`
358385
359 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
386 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
360387
361388 Permission policy for tool execution.
362389
from line 395
368395
369396 Tool calls require user confirmation before execution.
370397
371 - `type: "read"`
398 - `BetaManagedAgentsAutoPolicy object`
372399
400 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
401
373402 - `BetaManagedAgentsWriteToolConfig object`
374403
375404 Configuration for the write tool.
376405
406 - `type: "write"`
407
377408 - `enabled: boolean`
378409
379410 - `name: "write"`
380411
381 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
412 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
382413
383414 Permission policy for tool execution.
384415
from line 421
390421
391422 Tool calls require user confirmation before execution.
392423
393 - `type: "write"`
424 - `BetaManagedAgentsAutoPolicy object`
394425
426 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
427
395428 - `BetaManagedAgentsGlobToolConfig object`
396429
397430 Configuration for the glob tool.
398431
432 - `type: "glob"`
433
399434 - `enabled: boolean`
400435
401436 - `name: "glob"`
402437
403 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
438 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
404439
405440 Permission policy for tool execution.
406441
from line 447
412447
413448 Tool calls require user confirmation before execution.
414449
415 - `type: "glob"`
450 - `BetaManagedAgentsAutoPolicy object`
416451
452 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
453
417454 - `BetaManagedAgentsGrepToolConfig object`
418455
419456 Configuration for the grep tool.
420457
458 - `type: "grep"`
459
421460 - `enabled: boolean`
422461
423462 - `name: "grep"`
424463
425 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
464 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
426465
427466 Permission policy for tool execution.
428467
from line 473
434473
435474 Tool calls require user confirmation before execution.
436475
437 - `type: "grep"`
476 - `BetaManagedAgentsAutoPolicy object`
438477
478 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
479
439480 - `BetaManagedAgentsWebFetchToolConfig object`
440481
441482 Configuration for the web_fetch tool.
442483
484 - `type: "web_fetch"`
485
443486 - `enabled: boolean`
444487
445488 - `name: "web_fetch"`
446489
447 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
490 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
448491
449492 Permission policy for tool execution.
450493
from line 499
456499
457500 Tool calls require user confirmation before execution.
458501
459 - `type: "web_fetch"`
502 - `BetaManagedAgentsAutoPolicy object`
460503
504 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
505
461506 - `allowed_domains: optional array of string`
462507
463508 - `blocked_domains: optional array of string`
from line 515
470515
471516 Configuration for the web_search tool.
472517
518 - `type: "web_search"`
519
473520 - `enabled: boolean`
474521
475522 - `name: "web_search"`
476523
477 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
524 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
478525
479526 Permission policy for tool execution.
480527
from line 533
486533
487534 Tool calls require user confirmation before execution.
488535
489 - `type: "web_search"`
536 - `BetaManagedAgentsAutoPolicy object`
490537
538 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
539
491540 - `allowed_domains: optional array of string`
492541
493542 - `blocked_domains: optional array of string`
from line 577
528577
529578 - `enabled: boolean`
530579
531 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
580 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
532581
533582 Permission policy for tool execution.
534583
from line 589
540589
541590 Tool calls require user confirmation before execution.
542591
543 - `type: "agent_toolset_20260401"`
592 - `BetaManagedAgentsAutoPolicy object`
544593
594 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
595
545596 - `BetaManagedAgentsMCPToolset object`
546597
598 - `type: "mcp_toolset"`
599
547600 - `configs: array of BetaManagedAgentsMCPToolConfig`
548601
549602 - `enabled: boolean`
from line 603
550603
551604 - `name: string`
552605
553 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
606 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
554607
555608 Permission policy for tool execution.
556609
from line 615
562615
563616 Tool calls require user confirmation before execution.
564617
618 - `BetaManagedAgentsAutoPolicy object`
619
620 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
621
565622 - `default_config: BetaManagedAgentsMCPToolsetDefaultConfig`
566623
567624 Resolved default configuration for all tools from an MCP server.
from line 625
568625
569626 - `enabled: boolean`
570627
571 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
628 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
572629
573630 Permission policy for tool execution.
574631
from line 637
580637
581638 Tool calls require user confirmation before execution.
582639
583 - `mcp_server_name: string`
640 - `BetaManagedAgentsAutoPolicy object`
584641
585 - `type: "mcp_toolset"`
642 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
586643
644 - `mcp_server_name: string`
645
587646 - `BetaManagedAgentsCustomTool object`
588647
589648 A custom tool as returned in API responses.
590649
650 - `type: "custom"`
651
591652 - `description: string`
592653
593654 - `input_schema: BetaManagedAgentsCustomToolInputSchema`
from line 663
602663
603664 - `name: string`
604665
605 - `type: "custom"`
606
607 - `type: "agent"`
608
609666 - `version: number`
610667
611668 format: int32
from line 671
614671
615672 Platform advisor roster entry: a model the session's primary thread may consult mid-turn.
616673
674 - `type: "advisor"`
675
617676 - `model: string`
618677
619678 The advisor model id.
620679
621 - `type: "advisor"`
622
623680 - `archived_at: string or null`
624681
625682 A timestamp in RFC 3339 format
from line 730
673730 - `"rescheduling"`
674731
675732 - `"terminated"`
676
677 - `type: "session_thread"`
678733
679734 - `updated_at: string`
680735
No line in this hunk matches that.