The whole hunk
from line 1, old and new numbered
/
lines
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