List Session Threads
get/v1/sessions/{session_id}/threads?beta=true
Path parameters
session_idstring required
Path parameter session_id
Query parameters
limitinteger
Maximum results per page. Defaults to 1000.
pagestring
Opaque pagination cursor from a previous response's next_page. Forward-only.
Headers
x-api-keystring
anthropic-versionstring
anthropic-betastring
Response
Successful response (OK)
Example response
{
"data": [
{
"type": "session_thread",
"id": "sthr_011CZkZVWa6oIjw0rgXZpnBt",
"session_id": "sesn_011CZkZAtmR3yMPDzynEDxu7",
"status": "idle",
"agent": {
"type": "agent",
"id": "agent_011CZkYqphY8vELVzwCUpqiQ",
"version": 1,
"name": "Researcher",
"description": "A focused research subagent.",
"model": {
"id": "claude-sonnet-4-6",
"speed": "standard"
},
"system": "You are a research subagent that gathers and summarises sources for the coordinating agent.",
"tools": [
{
"type": "agent_toolset_20260401",
"default_config": {
"enabled": true,
"permission_policy": {
"type": "always_ask"
}
},
"configs": []
}
],
"mcp_servers": [],
"skills": []
},
"parent_thread_id": null,
"created_at": "2026-03-15T10:00:00Z",
"updated_at": "2026-03-15T10:00:00Z",
"archived_at": null,
"usage": {
"input_tokens": 0,
"output_tokens": 0,
"cache_read_input_tokens": 0,
"cache_creation": {
"ephemeral_5m_input_tokens": 0,
"ephemeral_1h_input_tokens": 0
}
},
"stats": {
"duration_seconds": 0,
"startup_seconds": 0,
"active_seconds": 0
}
}
],
"next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo="
}