Threads
api/beta/sessions/threads
History
api/beta/sessions/threads Changed · +79 / -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.
- `string` - - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more` + - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more` - `"message-batches-2024-09-24"`
- `"mid-conversation-tool-changes-2026-07-01"` + - `"compact-2026-01-12"` + + - `"computer-use-2025-11-24"` + + - `"mcp-tunnels-2026-06-22"` + + - `"structured-outputs-2025-11-13"` + + - `"task-budgets-2026-03-13"` + + - `"thinking-display-updates-2026-08-18"` + + - `"ce-user-management-2026-07-13"` + ### Returns - `data: optional array of BetaManagedAgentsSessionThread`
- `agent: BetaManagedAgentsSessionThreadAgent or BetaManagedAgentsAdvisor` - A session-resolved multiagent roster entry. + The resolved agent a session thread runs: a saved-agent snapshot, the platform advisor entry, or an inline-defined (ephemeral) agent snapshot. - `BetaManagedAgentsSessionThreadAgent object`
- `string` - - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more` + - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more` - `"message-batches-2024-09-24"`
- `"mid-conversation-tool-changes-2026-07-01"` + - `"compact-2026-01-12"` + + - `"computer-use-2025-11-24"` + + - `"mcp-tunnels-2026-06-22"` + + - `"structured-outputs-2025-11-13"` + + - `"task-budgets-2026-03-13"` + + - `"thinking-display-updates-2026-08-18"` + + - `"ce-user-management-2026-07-13"` + ### Returns - `BetaManagedAgentsSessionThread object`
- `agent: BetaManagedAgentsSessionThreadAgent or BetaManagedAgentsAdvisor` - A session-resolved multiagent roster entry. + The resolved agent a session thread runs: a saved-agent snapshot, the platform advisor entry, or an inline-defined (ephemeral) agent snapshot. - `BetaManagedAgentsSessionThreadAgent object`
- `string` - - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more` + - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more` - `"message-batches-2024-09-24"`
- `"mid-conversation-tool-changes-2026-07-01"` + - `"compact-2026-01-12"` + + - `"computer-use-2025-11-24"` + + - `"mcp-tunnels-2026-06-22"` + + - `"structured-outputs-2025-11-13"` + + - `"task-budgets-2026-03-13"` + + - `"thinking-display-updates-2026-08-18"` + + - `"ce-user-management-2026-07-13"` + ### Returns - `BetaManagedAgentsSessionThread object`
- `agent: BetaManagedAgentsSessionThreadAgent or BetaManagedAgentsAdvisor` - A session-resolved multiagent roster entry. + The resolved agent a session thread runs: a saved-agent snapshot, the platform advisor entry, or an inline-defined (ephemeral) agent snapshot. - `BetaManagedAgentsSessionThreadAgent object`
- `agent: BetaManagedAgentsSessionThreadAgent or BetaManagedAgentsAdvisor` - A session-resolved multiagent roster entry. + The resolved agent a session thread runs: a saved-agent snapshot, the platform advisor entry, or an inline-defined (ephemeral) agent snapshot. - `BetaManagedAgentsSessionThreadAgent object`
- `string` - - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more` + - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more` - `"message-batches-2024-09-24"`
- `"mid-conversation-tool-changes-2026-07-01"` + - `"compact-2026-01-12"` + + - `"computer-use-2025-11-24"` + + - `"mcp-tunnels-2026-06-22"` + + - `"structured-outputs-2025-11-13"` + + - `"task-budgets-2026-03-13"` + + - `"thinking-display-updates-2026-08-18"` + + - `"ce-user-management-2026-07-13"` + #### Returns - `data: optional array of BetaManagedAgentsSessionEvent`
- `string` - - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more` + - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more` - `"message-batches-2024-09-24"`
- `"mid-conversation-tool-changes-2026-07-01"` + - `"compact-2026-01-12"` + + - `"computer-use-2025-11-24"` + + - `"mcp-tunnels-2026-06-22"` + + - `"structured-outputs-2025-11-13"` + + - `"task-budgets-2026-03-13"` + + - `"thinking-display-updates-2026-08-18"` + + - `"ce-user-management-2026-07-13"` + #### Returns - `BetaManagedAgentsStreamSessionThreadEvents = BetaManagedAgentsUserMessageEvent or BetaManagedAgentsUserInterruptEvent or BetaManagedAgentsUserToolConfirmationEvent or 34 more`
- `BetaManagedAgentsSessionUpdatedEvent object` - Emitted when an UpdateSession request changed at least one field. Carries only the fields that changed; absent fields were not part of the update. The new configuration applies from the next turn. - - - `id: string` - - Unique identifier for this event. - - - `processed_at: string` - - A timestamp in RFC 3339 format - - format: date-time - - - `type: "session.updated"` - - - `agent: optional BetaManagedAgentsSessionAgent or null` - - Resolved `agent` definition for a `session`. Snapshot of the `agent` at `session` creation time. - - - `id: string` - - - `description: string or null` - - - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition` - - - `name: string` - - - `type: "url"` - - - `url: string` - - - `model: BetaManagedAgentsModelConfig` - - Model identifier and configuration. - - - `id: BetaManagedAgentsModel` - - The model that will power your agent. - - See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options. - - - `"claude-sonnet-5" or "claude-fable-5" or "claude-opus-5" or 10 more` - - The model that will power your agent. - - See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options. - - - `"claude-sonnet-5"` - - High-performance model for coding and agents - - - `"claude-fable-5"` - - Next generation of intelligence for the hardest knowledge work and coding problems - - - `"claude-opus-5"` - - Powerful intelligence for long-running agents and coding - - - `"claude-opus-4-8"` - - Powerful intelligence for long- + Emit
api/beta/sessions/threads Changed · +1329 / -1642 lines
### Path parameters ### Query parameters ### Headers #### Response (200) ### Path parameters ### Headers #### Response (200) ### Path parameters ### Headers #### Response (200) ## Domain types ## Threads › Events ### List Session Thread Events #### Path parameters #### Query parameters #### Headers #### Returns #### Example ##### Response (200) ### Stream Session Thread Events #### Path parameters #### Query parameters #### Headers #### Returns #### Example ##### Response (200) ### Path Parameters ### Query Parameters ### Header Parameters #### Response ### Path Parameters ### Header Parameters #### Response ### Path Parameters ### Header Parameters #### Response ## Domain Types # Events ## List Session Thread Events ### Path Parameters ### Query Parameters ### Header Parameters #### Response ## Stream Session Thread Events ### Path Parameters ### Query Parameters ### Header Parameters #### Response
This page is larger than the 256 KiB this site keeps, so one side of the diff below stops where the stored text does.
api/beta/sessions/threads Changed · +5780 / -4307 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.
api/beta/sessions/threads Changed · +18 / -8 lines
- `string` - - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more` + - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more` - `"message-batches-2024-09-24"`
- `"user-profiles-2026-03-24"` + - `"user-profiles-2026-08-18"` + - `"advisor-tool-2026-03-01"` - `"managed-agents-2026-04-01"`
} ], "model": { - "id": "claude-sonnet-4-6", + "id": "claude-opus-5", "effort": { "type": "low" },
- `string` - - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more` + - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more` - `"message-batches-2024-09-24"`
- `"user-profiles-2026-03-24"` + - `"user-profiles-2026-08-18"` + - `"advisor-tool-2026-03-01"` - `"managed-agents-2026-04-01"`
} ], "model": { - "id": "claude-sonnet-4-6", + "id": "claude-opus-5", "effort": { "type": "low" },
- `string` - - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more` + - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more` - `"message-batches-2024-09-24"`
- `"user-profiles-2026-03-24"` + - `"user-profiles-2026-08-18"` + - `"advisor-tool-2026-03-01"` - `"managed-agents-2026-04-01"`
} ], "model": { - "id": "claude-sonnet-4-6", + "id": "claude-opus-5", "effort": { "type": "low" },
- `string` - - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more` + - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more` - `"message-batches-2024-09-24"`
- `"user-profiles-2026-03-24"` + - `"user-profiles-2026-08-18"` + - `"advisor-tool-2026-03-01"` - `"managed-agents-2026-04-01"`
- `string` - - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more` + - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more` - `"message-batches-2024-09-24"`
- `"output-300k-2026-03-24"` - `"user-profiles-2026-03-24"` + + - `"user-profiles-2026-08-18"` - `"advisor-tool-2026-03-01"`
api/beta/sessions/threads First recorded · 8812 lines, first recorded
# Threads ## List Session Threads ### Path Parameters ### Query Parameters ### Header Parameters ### Returns ### Example #### Response ## Get Session Thread ### Path Parameters ### Header Parameters ### Returns ### Example #### Response ## Archive Session Thread ### Path Parameters ### Header Parameters ### Returns ### Example #### Response ## Domain Types ### Beta Managed Agents Session Thread ### Beta Managed Agents Session Thread Stats ### Beta Managed Agents Session Thread Status ### Beta Managed Agents Session Thread Usage ### Beta Managed Agents Stream Session Thread Events # Events ## List Session Thread Events ### Path Parameters ### Query Parameters ### Header Parameters ### Returns ### Example #### Response ## Stream Session Thread Events ### Path Parameters ### Query Parameters ### Header Parameters ### Returns ### Example #### Response
The first capture of this source. The page was already there, and this is what it said.
---
title: Threads
url: https://platform.claude.com/docs/en/api/beta/sessions/threads
---
# Threads
## List Session Threads
**get** `/v1/sessions/{session_id}/threads`
List Session Threads
### Path Parameters
- `session_id: string`
### Query Parameters
- `limit: optional number`
Maximum results per page. Defaults to 1000.
- `page: optional string`
Opaque pagination cursor from a previous response's next_page. Forward-only.
### Header Parameters
- `"anthropic-beta": optional array of AnthropicBeta`
Optional header to specify the beta version(s) you want to use.
- `string`
- `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
- `"message-batches-2024-09-24"`
- `"prompt-caching-2024-07-31"`
- `"computer-use-2024-10-22"`
- `"computer-use-2025-01-24"`
- `"pdfs-2024-09-25"`
- `"token-counting-2024-11-01"`
- `"token-efficient-tools-2025-02-19"`
- `"output-128k-2025-02-19"`
- `"files-api-2025-04-14"`
- `"mcp-client-2025-04-04"`
- `"mcp-client-2025-11-20"`
- `"dev-full-thinking-2025-05-14"`
- `"interleaved-thinking-2025-05-14"`
- `"code-execution-2025-05-22"`
- `"extended-cache-ttl-2025-04-11"`
- `"context-1m-2025-08-07"`
- `"context-management-2025-06-27"`
- `"model-context-window-exceeded-2025-08-26"`
- `"skills-2025-10-02"`
- `"fast-mode-2026-02-01"`
- `"output-300k-2026-03-24"`
- `"user-profiles-2026-03-24"`
- `"advisor-tool-2026-03-01"`
- `"managed-agents-2026-04-01"`
- `"cache-diagnosis-2026-04-07"`
- `"dreaming-2026-04-21"`
- `"thinking-token-count-2026-05-13"`
- `"server-side-fallback-2026-06-01"`
- `"server-side-fallback-2026-07-01"`
- `"fallback-credit-2026-06-01"`
- `"fallback-credit-2026-07-01"`
- `"agent-memory-2026-07-22"`
- `"mid-conversation-tool-changes-2026-07-01"`
### Returns
- `data: optional array of BetaManagedAgentsSessionThread`
Threads in the session, primary first then children in spawn order.
- `id: string`
Unique identifier for this thread.
- `agent: BetaManagedAgentsSessionThreadAgent or BetaManagedAgentsAdvisor`
A session-resolved multiagent roster entry.
- `BetaManagedAgentsSessionThreadAgent object { id, description, mcp_servers, 7 more }`
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`.
- `id: string`
- `description: string or null`
- `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
- `name: string`
- `type: "url"`
- `"url"`
- `url: string`
- `model: BetaManagedAgentsModelConfig`
Model identifier and configuration.
- `id: BetaManagedAgentsModel`
The model that will power your agent.
See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
- `"claude-sonnet-5" or "claude-fable-5" or "claude-opus-5" or 10 more`
The model that will power your agent.
See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
- `"claude-sonnet-5"`
High-performance model for coding and agents
- `"claude-fable-5"`
Next generation of intelligence for the hardest knowledge work and coding problems
- `"claude-opus-5"`
Powerful intelligence for long-running agents and coding
- `"claude-opus-4-8"`
Powerful intelligence for long-running agents and coding
- `"claude-opus-4-7"`
Powerful intelligence for long-running agents and coding
- `"claude-opus-4-6"`
Powerful intelligence for long-running agents and coding
- `"claude-sonnet-4-6"`
Best combination of speed and intelligence
- `"claude-haiku-4-5"`
Fastest model with near-frontier intelligence
- `"claude-haiku-4-5-20251001"`
Fastest model with near-frontier intelligence
- `"claude-opus-4-5"`
Powerful intelligence for long-running agents and coding
- `"claude-opus-4-5-20251101"`
Powerful intelligence for long-running agents and coding
- `"claude-sonnet-4-5"`
High-performance model for agents and coding
- `"claude-sonnet-4-5-20250929"`
High-performance model for agents and coding
- `string`
- `effort: optional BetaManagedAgentsEffortLow or BetaManagedAgentsEffortMedium or BetaManagedAgentsEffortHigh or 2 more`
How hard Claude works on each turn. Sets `output_config.effort` on every Messages call the session makes.
- `BetaManagedAgentsEffortLow object { type }`
Low effort. Favors latency over reasoning depth.
- `type: "low"`
- `"low"`
- `BetaManagedAgentsEffortMedium object { type }`
Medium effort. Balances latency and reasoning depth.
- `type: "medium"`
- `"medium"`
- `BetaManagedAgentsEffortHigh object { type }`
High effort. Favors reasoning depth.
- `type: "high"`
- `"high"`
- `BetaManagedAgentsEffortXhigh object { type }`
Extra-high effort. Not all models accept this level.
- `type: "xhigh"`
- `"xhigh"`
- `BetaManagedAgentsEffortMax object { type }`
Maximum effort. Favors reasoning depth over latency.
- `type: "max"`
- `"max"`
- `inference_geo: optional string`
Geographic region for model inference. When unset, requests fall through to the workspace's default_inference_geo.
- `speed: optional "standard" or "fast"`
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.
- `"standard"`
- `"fast"`
- `name: string`
- `skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill`
- `BetaManagedAgentsAnthropicSkill object { skill_id, type, version }`
A resolved Anthropic-managed skill.
- `skill_id: string`
- `type: "anthropic"`
- `"anthropic"`
- `version: string`
- `BetaManagedAgentsCustomSkill object { skill_id, type, version }`
A resolved user-created custom skill.
- `skill_id: string`
- `type: "custom"`
- `"custom"`
- `version: string`
- `system: string or null`
- `tools: array of BetaManagedAgentsAgentToolset20260401 or BetaManagedAgentsMCPToolset or BetaManagedAgentsCustomTool`
- `BetaManagedAgentsAgentToolset20260401 object { configs, default_config, type }`
- `configs: array of BetaManagedAgentsAgentToolConfig`
- `enabled: boolean`
- `name: "bash" or "edit" or "read" or 5 more`
Cut at 300 lines.