列出线程事件

先调用「创建会话」，用返回的会话 ID 替换示例 ID。

GET /agent/v1/sessions/{session_id}/threads/{thread_id}/events◐ 部分支持

请求参数

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.
thread_idstring必填
path: Execution thread id (sthr_...), as listed by sessions.threads.list; the primary thread id equals the session's own thread. Unknown or foreign ids return 404.
session_idstring必填
query: 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.

200

读取所选线程自己的事件记录：主线程读主会话，子线程读对应子会话。沿用会话事件接口的查询参数、公开事件类型和 data + next_page 信封。使用网页工具时，两个接口均返回 search_result 块；回答 citations 为 /agent/v1 扩展，/anthropic 将引用显示为正文 [n]。

错误按 Anthropic 错误格式返回（type / message / request_id），参见错误码

响应

HTTP 200

Successful response

application/json

名称	类型	说明
data	array<object>	Items of this page, in the order requested by the call.
data[].id	string	Unique identifier for this event. / Event id, unique within the session. Use it to refer to this event, for example in user.tool_confirmation or user.steer. / Event id, unique within the session. / Event id, unique within the session. Use it to refer to this event, for example in user.tool_confirmation or user.steer. / Event id, unique within the session. Use it to refer to this event, for example in user.tool_confirmation or user.steer.
data[].content	array<object>	Array of content blocks comprising the user message. / The result content returned by the tool. / Array of text blocks comprising the agent response. / The result content returned by the tool. / The result content returned by the tool. / Message content blocks. / Message content blocks. / The result content returned by the tool. / System content blocks. Text-only.
data[].type	string	Always `user.message`. A message from the user to the agent, with content blocks. / Always `user.interrupt`. The user interrupted the running turn. / Always `user.tool_confirmation`. The user's decision to allow or deny a tool call that waits for approval. / Always `user.custom_tool_result`. The user's result for a custom tool call. / Always `agent.custom_tool_use`. The agent called a custom tool defined by the client. / Always `agent.message`. A message from the agent, with text content blocks. / Always `agent.thinking`. The agent's thinking text for a step. / Always `agent.mcp_tool_use`. The agent called an MCP tool. / Always `agent.mcp_tool_result`. The result of an MCP tool call. / Always `agent.tool_use`. The agent called a tool. / Always `agent.tool_result`. The result of a tool call. / Always `agent.thread_message_received`. The agent received a message from another thread. / Always `agent.thread_message_sent`. The agent sent a message to another thread. / Always `agent.thread_context_compacted`. The thread's context was compacted into a summary. / Always `session.error`. The session hit an error. / Always `session.status_rescheduled`. The session will retry after a recoverable error. / Always `session.status_running`. The session started running a turn. / Always `session.status_idle`. The session stopped running; stop_reason says why. / Always `session.status_terminated`. The session ended and accepts no more work. / Always `session.thread_created`. A child thread was started. / Always `span.outcome_evaluation_start`. An outcome evaluation started. / Always `span.outcome_evaluation_end`. An outcome evaluation ended. / Always `span.model_request_start`. A model request started. / Always `span.model_request_end`. A model request ended, with its usage. / Always `span.outcome_evaluation_ongoing`. An outcome evaluation is still running. / Always `user.define_outcome`. The user defined the outcome the agent should reach. / Always `session.deleted`. The session was deleted. / Always `session.thread_status_running`. A thread started running. / Always `session.thread_status_idle`. A thread stopped running; stop_reason says why. / Always `session.thread_status_terminated`. A thread ended. / Always `user.tool_result`. The user's result for a client-side tool call. / Always `session.thread_status_rescheduled`. A thread will retry after a recoverable error. / Always `session.updated`. The session's model, title, metadata, agent or budget changed. / Always `system.message`. A message produced by the platform rather than the user or the agent. / Always `session.usage`. Cumulative usage of the session. / Always `session.forked`. The session was created by forking another session. / Always `session.goal_changed`. / Always `session.goal_verification`. / Always `user.steer`. Receipt that a queued user.message was injected into the running turn.
data[].processed_at	null \| string \| string \| string \| string \| string \| string \| string \| string \| string \| string \| string \| string \| string \| string \| string \| string \| string \| string \| string \| string \| string \| string \| string \| string \| string \| string \| string \| null \| string \| string \| string \| null \| string \| string \| string \| string \| string \| string	A timestamp in RFC 3339 format / RFC 3339 time at which the server processed the event; null while a queued input has not started running. / When the event was recorded, RFC 3339. / RFC 3339 time at which the server processed the event; null while a queued input has not started running. / RFC 3339 time at which the server processed the event; null while a queued input has not started running.
data[].message_id	string	UI transcript message ID. Use the last assistant message in a successfully completed turn as the fork target. / UI transcript message ID shared with this assistant's message parts.
data[].session_thread_id	null \| string \| string \| string \| string \| string \| null \| string \| string	If absent, interrupts every non-archived thread in a multiagent session (or the primary alone in a single-agent session). If present, interrupts only the named thread. / Set by the server to the subagent thread this confirmation was routed to. Omitted when it was routed to the primary thread. / Set by the server to the subagent thread this result was routed to. Omitted when it was routed to the primary thread. / When set, this event was cross-posted from a subagent's thread to surface its custom tool use on the primary thread's stream. Empty on the thread's own events. Informational only: the server routes the matching `user.custom_tool_result` by `custom_tool_use_id`, so clients do not send it back. / When set, this event was cross-posted from a subagent's thread to surface its permission request on the primary thread's stream. Empty on the thread's own events. Informational only: the server routes the matching `user.tool_confirmation` by `tool_use_id`, so clients do not send it back. / When set, this event was cross-posted from a subagent's thread to surface its permission request on the primary thread's stream. Empty on the thread's own events. Informational only: the server routes the matching `user.tool_confirmation` or `user.tool_result` by `tool_use_id`, so clients do not send it back. / Public `sthr_` ID of the newly created thread. / Public sthr_ ID of the thread that started running. / Public sthr_ ID of the thread that went idle. / Public sthr_ ID of the thread that terminated. / Set by the server to the subagent thread this result was routed to. Omitted when it was routed to the primary thread. / Public sthr_ ID of the thread that is retrying.
data[].result	string	UserToolConfirmationResult enum / Evaluation verdict. 'satisfied': criteria met, session goes idle. 'needs_revision': criteria not met, another revision cycle follows. 'max_iterations_reached': evaluation budget exhausted with criteria still unmet — one final acknowledgment turn follows before the session goes idle, but no further evaluation runs. 'failed': grader determined the rubric does not apply to the deliverables. 'interrupted': user sent an interrupt while evaluation was in progress.
data[].tool_use_id	string	The id of the `agent.tool_use` or `agent.mcp_tool_use` event this result corresponds to, which can be found in the last `session.status_idle` event's `stop_reason.event_ids` field. / The id of the `agent.tool_use` event this result corresponds to. / The id of the `agent.tool_use` event this result corresponds to, which can be found in the last `session.status_idle` event's `stop_reason.event_ids` field.
data[].deny_message	null \| string	Optional message providing context for a 'deny' decision. Only allowed when result is 'deny'.
data[].custom_tool_use_id	string	The id of the `agent.custom_tool_use` event this result corresponds to, which can be found in the last `session.status_idle` event's `stop_reason.event_ids` field.
data[].is_error	null \| boolean	Whether the tool execution resulted in an error. / Whether the model request resulted in an error. / Whether the tool execution resulted in an error.
data[].input	object	Input parameters for the tool call.
data[].name	string	Name of the custom tool being called. / Name of the MCP tool being used. / Name of the agent tool being used.
data[].mcp_server_name	string	Name of the MCP server providing the tool.
data[].evaluated_permission	string	AgentEvaluatedPermission enum
data[].evaluation	object	Names the resolved permission_policy that produced evaluated_permission, and under auto carries the judgement. Open union: clients must tolerate unknown variants.
data[].parent_tool_use_id	string	Praxis extension (MCP Apps, SEP-1865): present when `source` is `codemode`; the id of the codemode tool use whose program made this call. Absent otherwise.
data[]._meta	object	Praxis extension (MCP Apps, SEP-1865): the `ui` and `openai/ui` keys of the MCP tool definition's `_meta`, verbatim; other `_meta` keys are not exposed. When `ui.resourceUri` is a `ui://` URI, the tool has an interactive view: a client that implements MCP Apps can fetch that resource from the MCP server and render it for this call. Absent when the tool declares neither key. Clients that do not render MCP Apps ignore it. / Praxis extension (MCP Apps, SEP-1865): the MCP CallToolResult `_meta`, verbatim. Views use it for data that should not reach the model; absent when the tool returned none.
data[].source	string	Praxis extension (MCP Apps, SEP-1865): `app` when the call was made by an MCP Apps view, `codemode` when a program run by the codemode tool called an MCP tool that declares a view (the event pair exists so a client can render that view; the model already has the result in the codemode tool result); absent for the model's own calls. / What caused the change.
data[].mcp_tool_use_id	string	The id of the `agent.mcp_tool_use` event this result corresponds to.
data[].structured_content	any	Praxis extension (MCP Apps, SEP-1865): the MCP CallToolResult `structuredContent`, verbatim JSON. MCP Apps views read it as the data to render; absent when the tool returned none.
data[].from_session_thread_id	string	Public `sthr_` ID of the thread that sent the message.
data[].from_agent_name	null \| string	Name of the callable agent this message came from. Absent when received from the primary agent.
data[].to_session_thread_id	string	Public `sthr_` ID of the thread the message was sent to.
data[].to_agent_name	null \| string	Name of the callable agent this message was sent to. Absent when sent to the primary agent.
data[].error	object	Description of the error and what the client should do next.
data[].stop_reason	object	Why the session stopped running, with the variant data needed to continue.
data[].agent_name	string	Name of the callable agent the thread runs. / Name of the agent the thread runs. / Name of the agent the thread runs. / Name of the agent the thread runs. / Name of the agent the thread runs.
data[].iteration	number	0-indexed revision cycle. 0 is the first evaluation; 1 is the re-evaluation after the first revision; etc. / 0-indexed revision cycle, matching the corresponding `span.outcome_evaluation_start`. / 0-indexed revision cycle, matching the corresponding `span.outcome_evaluation_start`.
data[].outcome_id	string	The `outc_` ID of the outcome being evaluated. / Server-generated `outc_` ID for this outcome. Referenced by `span.outcome_evaluation_*` events and the session's `outcome_evaluations` list.
data[].explanation	string	Human-readable explanation of the verdict. For `needs_revision`, describes which criteria failed and why.
data[].outcome_evaluation_start_id	string	The id of the corresponding `span.outcome_evaluation_start` event.
data[].usage	object	Token usage for a single model request. / Point-in-time snapshot of a session's cumulative usage.
data[].model_request_start_id	string	The id of the corresponding `span.model_request_start` event.
data[].model_usage	object	Token usage for a single model request.
data[].description	string	What the agent should produce. Copied from the input event.
data[].max_iterations	null \| number	Evaluate-then-revise cycles before giving up. Default 3, max 20.
data[].rubric	object	Rubric for grading the quality of an outcome.
data[].agent	null \| object	Resolved `agent` definition for a `session`. Snapshot of the `agent` at `session` creation time.
data[].budget	null \| object	A hard spend ceiling. The session stops issuing new model requests once the tracked list cost reaches `max_list_cost`.
data[].metadata	object	The session's full metadata bag after the update. Present when the update set non-empty metadata; absent when metadata was unchanged or cleared to empty.
data[].title	null \| string	The session's new title. Present only when the update changed it.
data[].model	object	扩展 / Praxis extension: the changed session model, present only on /agent/v1 session.updated events. Model-only updates are omitted on /anthropic.
data[].forked_from_session_id	string	Id of the parent session this session was forked from.
data[].forked_from_message_id	string	message_id of the agent message in the parent session up to which the conversation was copied.
data[].action	string	What changed in the goal.
data[].goal	object \| null	The goal as the change left it, or null when the session has no goal.
data[].previous_goal	object \| null	The goal before the change, or null when there was none.
data[].status	string	Where the check stands. Read `verification.passed` on the closing event to know whether the goal counts as done.
data[].goal_id	string	The goal this check belongs to.
data[].goal_iteration	integer	Which check of this goal, matching `iteration` on the goal.
data[].verification_id	string	Identifier shared by every event of one check.
data[].anchor_message_id	string \| null	The assistant message the check follows, or null.
data[].verification	object	The verdict; absent on `started`.
data[].event_id	string	Id of the event this event refers to.
next_page	string \| null	Opaque cursor for the next page: pass it unchanged as page to continue. Null when this is the last page.