List Threads

Call Create session first and replace the example session ID with its returned ID.

GET /agent/v1/sessions/{session_id}/threads◐ Partial

Request parameters

session_idstring必填
path: Session id (sesn_...), as returned by sessions.create or sessions.list. The same id is also accepted as the session_id query parameter on resource and thread calls, where it must equal the path value.
limitnumber可选
query: Number of items per page.
pagestring可选
query: Opaque pagination cursor: pass the next_page value of the previous response unchanged. Omit it for the first page. A cursor from a different query or a malformed one returns 400.

Returns

200

Returns the primary thread and every child thread in created_at order. Thread ids use sthr_ plus the owning session suffix; children reference the primary parent_thread_id and retain the parent session_id. agent describes the actual running definition; built-in types use their type name and null for unregistered id/version. Archived children have status terminated and archived_at. stats/usage remain null without thread-level tracking.

Errors follow the Anthropic error format (type / message / request_id) — see error codes

Response

HTTP 200

Successful response

application/json

Name	Type	Description
data	array<object>	Items of this page, in the order requested by the call.
data[].id	string	Unique identifier for this thread.
data[].agent	object	The resolved agent a `session_thread` runs.
data[].archived_at	null \| string	A timestamp in RFC 3339 format
data[].created_at	string	A timestamp in RFC 3339 format
data[].parent_thread_id	null \| string	Parent thread that spawned this thread. Null for the primary thread.
data[].session_id	string	The session this thread belongs to.
data[].stats	null \| object	Timing statistics for a session thread.
data[].status	string	SessionThreadStatus enum
data[].type	string	Always `session_thread`. An execution thread of a session.
data[].updated_at	string	A timestamp in RFC 3339 format
data[].usage	null \| object	Cumulative token usage for a session thread across all turns.
next_page	string \| null	Opaque cursor for the next page: pass it unchanged as page to continue. Null when this is the last page.