# Threads ## List Session Threads `$client->beta->sessions->threads->list(string sessionID, ?int limit, ?string page, ?list betas): PageCursor` **get** `/v1/sessions/{session_id}/threads` List Session Threads ### Parameters - `sessionID: string` - `limit?:optional int` Maximum results per page. Defaults to 1000. - `page?:optional string` Opaque pagination cursor from a previous response's next_page. Forward-only. - `betas?:optional list` Optional header to specify the beta version(s) you want to use. ### Returns - `ManagedAgentsSessionThread` - `string id` Unique identifier for this thread. - `BetaManagedAgentsSessionThreadAgent agent` 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`. - `?\Datetime archivedAt` A timestamp in RFC 3339 format - `\Datetime createdAt` A timestamp in RFC 3339 format - `?string parentThreadID` Parent thread that spawned this thread. Null for the primary thread. - `string sessionID` The session this thread belongs to. - `?ManagedAgentsSessionThreadStats stats` Timing statistics for a session thread. - `ManagedAgentsSessionThreadStatus status` SessionThreadStatus enum - `Type type` - `\Datetime updatedAt` A timestamp in RFC 3339 format - `?ManagedAgentsSessionThreadUsage usage` Cumulative token usage for a session thread across all turns. ### Example ```php beta->sessions->threads->list( 'sesn_011CZkZAtmR3yMPDzynEDxu7', limit: 0, page: 'page', betas: ['message-batches-2024-09-24'], ); var_dump($page); ``` #### Response ```json { "data": [ { "id": "sthr_011CZkZVWa6oIjw0rgXZpnBt", "agent": { "id": "agent_011CZkYqphY8vELVzwCUpqiQ", "description": "A focused research subagent.", "mcp_servers": [ { "name": "example-mcp", "type": "url", "url": "https://example-server.modelcontextprotocol.io/sse" } ], "model": { "id": "claude-sonnet-4-6", "speed": "standard" }, "name": "Researcher", "skills": [ { "skill_id": "xlsx", "type": "anthropic", "version": "1" } ], "system": "You are a research subagent that gathers and summarises sources for the coordinating agent.", "tools": [ { "configs": [ { "enabled": true, "name": "bash", "permission_policy": { "type": "always_allow" } } ], "default_config": { "enabled": true, "permission_policy": { "type": "always_ask" } }, "type": "agent_toolset_20260401" } ], "type": "agent", "version": 1 }, "archived_at": null, "created_at": "2026-03-15T10:00:00Z", "parent_thread_id": null, "session_id": "sesn_011CZkZAtmR3yMPDzynEDxu7", "stats": { "active_seconds": 0, "duration_seconds": 0, "startup_seconds": 0 }, "status": "idle", "type": "session_thread", "updated_at": "2026-03-15T10:00:00Z", "usage": { "cache_creation": { "ephemeral_1h_input_tokens": 0, "ephemeral_5m_input_tokens": 0 }, "cache_read_input_tokens": 0, "input_tokens": 0, "output_tokens": 0 } } ], "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo=" } ``` ## Get Session Thread `$client->beta->sessions->threads->retrieve(string threadID, string sessionID, ?list betas): ManagedAgentsSessionThread` **get** `/v1/sessions/{session_id}/threads/{thread_id}` Get Session Thread ### Parameters - `sessionID: string` - `threadID: string` - `betas?:optional list` Optional header to specify the beta version(s) you want to use. ### Returns - `ManagedAgentsSessionThread` - `string id` Unique identifier for this thread. - `BetaManagedAgentsSessionThreadAgent agent` 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`. - `?\Datetime archivedAt` A timestamp in RFC 3339 format - `\Datetime createdAt` A timestamp in RFC 3339 format - `?string parentThreadID` Parent thread that spawned this thread. Null for the primary thread. - `string sessionID` The session this thread belongs to. - `?ManagedAgentsSessionThreadStats stats` Timing statistics for a session thread. - `ManagedAgentsSessionThreadStatus status` SessionThreadStatus enum - `Type type` - `\Datetime updatedAt` A timestamp in RFC 3339 format - `?ManagedAgentsSessionThreadUsage usage` Cumulative token usage for a session thread across all turns. ### Example ```php beta->sessions->threads->retrieve( 'sthr_011CZkZVWa6oIjw0rgXZpnBt', sessionID: 'sesn_011CZkZAtmR3yMPDzynEDxu7', betas: ['message-batches-2024-09-24'], ); var_dump($betaManagedAgentsSessionThread); ``` #### Response ```json { "id": "sthr_011CZkZVWa6oIjw0rgXZpnBt", "agent": { "id": "agent_011CZkYqphY8vELVzwCUpqiQ", "description": "A focused research subagent.", "mcp_servers": [ { "name": "example-mcp", "type": "url", "url": "https://example-server.modelcontextprotocol.io/sse" } ], "model": { "id": "claude-sonnet-4-6", "speed": "standard" }, "name": "Researcher", "skills": [ { "skill_id": "xlsx", "type": "anthropic", "version": "1" } ], "system": "You are a research subagent that gathers and summarises sources for the coordinating agent.", "tools": [ { "configs": [ { "enabled": true, "name": "bash", "permission_policy": { "type": "always_allow" } } ], "default_config": { "enabled": true, "permission_policy": { "type": "always_ask" } }, "type": "agent_toolset_20260401" } ], "type": "agent", "version": 1 }, "archived_at": null, "created_at": "2026-03-15T10:00:00Z", "parent_thread_id": null, "session_id": "sesn_011CZkZAtmR3yMPDzynEDxu7", "stats": { "active_seconds": 0, "duration_seconds": 0, "startup_seconds": 0 }, "status": "idle", "type": "session_thread", "updated_at": "2026-03-15T10:00:00Z", "usage": { "cache_creation": { "ephemeral_1h_input_tokens": 0, "ephemeral_5m_input_tokens": 0 }, "cache_read_input_tokens": 0, "input_tokens": 0, "output_tokens": 0 } } ``` ## Archive Session Thread `$client->beta->sessions->threads->archive(string threadID, string sessionID, ?list betas): ManagedAgentsSessionThread` **post** `/v1/sessions/{session_id}/threads/{thread_id}/archive` Archive Session Thread ### Parameters - `sessionID: string` - `threadID: string` - `betas?:optional list` Optional header to specify the beta version(s) you want to use. ### Returns - `ManagedAgentsSessionThread` - `string id` Unique identifier for this thread. - `BetaManagedAgentsSessionThreadAgent agent` 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`. - `?\Datetime archivedAt` A timestamp in RFC 3339 format - `\Datetime createdAt` A timestamp in RFC 3339 format - `?string parentThreadID` Parent thread that spawned this thread. Null for the primary thread. - `string sessionID` The session this thread belongs to. - `?ManagedAgentsSessionThreadStats stats` Timing statistics for a session thread. - `ManagedAgentsSessionThreadStatus status` SessionThreadStatus enum - `Type type` - `\Datetime updatedAt` A timestamp in RFC 3339 format - `?ManagedAgentsSessionThreadUsage usage` Cumulative token usage for a session thread across all turns. ### Example ```php beta->sessions->threads->archive( 'sthr_011CZkZVWa6oIjw0rgXZpnBt', sessionID: 'sesn_011CZkZAtmR3yMPDzynEDxu7', betas: ['message-batches-2024-09-24'], ); var_dump($betaManagedAgentsSessionThread); ``` #### Response ```json { "id": "sthr_011CZkZVWa6oIjw0rgXZpnBt", "agent": { "id": "agent_011CZkYqphY8vELVzwCUpqiQ", "description": "A focused research subagent.", "mcp_servers": [ { "name": "example-mcp", "type": "url", "url": "https://example-server.modelcontextprotocol.io/sse" } ], "model": { "id": "claude-sonnet-4-6", "speed": "standard" }, "name": "Researcher", "skills": [ { "skill_id": "xlsx", "type": "anthropic", "version": "1" } ], "system": "You are a research subagent that gathers and summarises sources for the coordinating agent.", "tools": [ { "configs": [ { "enabled": true, "name": "bash", "permission_policy": { "type": "always_allow" } } ], "default_config": { "enabled": true, "permission_policy": { "type": "always_ask" } }, "type": "agent_toolset_20260401" } ], "type": "agent", "version": 1 }, "archived_at": null, "created_at": "2026-03-15T10:00:00Z", "parent_thread_id": null, "session_id": "sesn_011CZkZAtmR3yMPDzynEDxu7", "stats": { "active_seconds": 0, "duration_seconds": 0, "startup_seconds": 0 }, "status": "idle", "type": "session_thread", "updated_at": "2026-03-15T10:00:00Z", "usage": { "cache_creation": { "ephemeral_1h_input_tokens": 0, "ephemeral_5m_input_tokens": 0 }, "cache_read_input_tokens": 0, "input_tokens": 0, "output_tokens": 0 } } ``` ## Domain Types ### Beta Managed Agents Session Thread - `ManagedAgentsSessionThread` - `string id` Unique identifier for this thread. - `BetaManagedAgentsSessionThreadAgent agent` 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`. - `?\Datetime archivedAt` A timestamp in RFC 3339 format - `\Datetime createdAt` A timestamp in RFC 3339 format - `?string parentThreadID` Parent thread that spawned this thread. Null for the primary thread. - `string sessionID` The session this thread belongs to. - `?ManagedAgentsSessionThreadStats stats` Timing statistics for a session thread. - `ManagedAgentsSessionThreadStatus status` SessionThreadStatus enum - `Type type` - `\Datetime updatedAt` A timestamp in RFC 3339 format - `?ManagedAgentsSessionThreadUsage usage` Cumulative token usage for a session thread across all turns. ### Beta Managed Agents Session Thread Stats - `ManagedAgentsSessionThreadStats` - `?float activeSeconds` Cumulative time in seconds the thread spent actively running. Excludes idle time. - `?float durationSeconds` Elapsed time since thread creation in seconds. For archived threads, frozen at the final update. - `?float startupSeconds` Time in seconds for the thread to begin running. Zero for child threads, which start immediately. ### Beta Managed Agents Session Thread Status - `ManagedAgentsSessionThreadStatus` - `"running"` - `"idle"` - `"rescheduling"` - `"terminated"` ### Beta Managed Agents Session Thread Usage - `ManagedAgentsSessionThreadUsage` - `?BetaManagedAgentsCacheCreationUsage cacheCreation` Prompt-cache creation token usage broken down by cache lifetime. - `?int cacheReadInputTokens` Total tokens read from prompt cache. - `?int inputTokens` Total input tokens consumed across all turns. - `?int outputTokens` Total output tokens generated across all turns. ### Beta Managed Agents Stream Session Thread Events - `ManagedAgentsStreamSessionThreadEvents` - `ManagedAgentsUserMessageEvent` - `string id` Unique identifier for this event. - `list content` Array of content blocks comprising the user message. - `Type type` - `?\Datetime processedAt` A timestamp in RFC 3339 format - `ManagedAgentsUserInterruptEvent` - `string id` Unique identifier for this event. - `Type type` - `?\Datetime processedAt` A timestamp in RFC 3339 format - `?string sessionThreadID` 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. - `ManagedAgentsUserToolConfirmationEvent` - `string id` Unique identifier for this event. - `Result result` UserToolConfirmationResult enum - `string toolUseID` 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](https://platform.claude.com/docs/en/api/beta/sessions/events/list#beta_managed_agents_session_requires_action.event_ids) `stop_reason.event_ids` field. - `Type type` - `?string denyMessage` Optional message providing context for a 'deny' decision. Only allowed when result is 'deny'. - `?\Datetime processedAt` A timestamp in RFC 3339 format - `?string sessionThreadID` When set, the confirmation routes to this subagent's thread rather than the primary. Echo this from the `session_thread_id` on the `agent.tool_use` or `agent.mcp_tool_use` event that prompted the approval. - `ManagedAgentsUserCustomToolResultEvent` - `string id` Unique identifier for this event. - `string customToolUseID` 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](https://platform.claude.com/docs/en/api/beta/sessions/events/list#beta_managed_agents_session_requires_action.event_ids) `stop_reason.event_ids` field. - `Type type` - `?list content` The result content returned by the tool. - `?bool isError` Whether the tool execution resulted in an error. - `?\Datetime processedAt` A timestamp in RFC 3339 format - `?string sessionThreadID` Routes this result to a subagent thread. Copy from the `agent.custom_tool_use` event's `session_thread_id`. - `ManagedAgentsAgentCustomToolUseEvent` - `string id` Unique identifier for this event. - `array input` Input parameters for the tool call. - `string name` Name of the custom tool being called. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `?string sessionThreadID` 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. Echo this on a `user.custom_tool_result` event to route the result back. - `ManagedAgentsAgentMessageEvent` - `string id` Unique identifier for this event. - `list content` Array of text blocks comprising the agent response. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `ManagedAgentsAgentThinkingEvent` - `string id` Unique identifier for this event. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `ManagedAgentsAgentMCPToolUseEvent` - `string id` Unique identifier for this event. - `array input` Input parameters for the tool call. - `string mcpServerName` Name of the MCP server providing the tool. - `string name` Name of the MCP tool being used. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `?EvaluatedPermission evaluatedPermission` AgentEvaluatedPermission enum - `?string sessionThreadID` 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. Echo this on a `user.tool_confirmation` event to route the approval back. - `ManagedAgentsAgentMCPToolResultEvent` - `string id` Unique identifier for this event. - `string mcpToolUseID` The id of the `agent.mcp_tool_use` event this result corresponds to. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `?list content` The result content returned by the tool. - `?bool isError` Whether the tool execution resulted in an error. - `ManagedAgentsAgentToolUseEvent` - `string id` Unique identifier for this event. - `array input` Input parameters for the tool call. - `string name` Name of the agent tool being used. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `?EvaluatedPermission evaluatedPermission` AgentEvaluatedPermission enum - `?string sessionThreadID` 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. Echo this on a `user.tool_confirmation` event to route the approval back. - `ManagedAgentsAgentToolResultEvent` - `string id` Unique identifier for this event. - `\Datetime processedAt` A timestamp in RFC 3339 format - `string toolUseID` The id of the `agent.tool_use` event this result corresponds to. - `Type type` - `?list content` The result content returned by the tool. - `?bool isError` Whether the tool execution resulted in an error. - `ManagedAgentsAgentThreadMessageReceivedEvent` - `string id` Unique identifier for this event. - `list content` Message content blocks. - `string fromSessionThreadID` Public `sthr_` ID of the thread that sent the message. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `?string fromAgentName` Name of the callable agent this message came from. Absent when received from the primary agent. - `ManagedAgentsAgentThreadMessageSentEvent` - `string id` Unique identifier for this event. - `list content` Message content blocks. - `\Datetime processedAt` A timestamp in RFC 3339 format - `string toSessionThreadID` Public `sthr_` ID of the thread the message was sent to. - `Type type` - `?string toAgentName` Name of the callable agent this message was sent to. Absent when sent to the primary agent. - `ManagedAgentsAgentThreadContextCompactedEvent` - `string id` Unique identifier for this event. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `ManagedAgentsSessionErrorEvent` - `string id` Unique identifier for this event. - `Error error` An unknown or unexpected error occurred during session execution. A fallback variant; clients that don't recognize a new error code can match on `retry_status` and `message` alone. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `ManagedAgentsSessionStatusRescheduledEvent` - `string id` Unique identifier for this event. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `ManagedAgentsSessionStatusRunningEvent` - `string id` Unique identifier for this event. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `ManagedAgentsSessionStatusIdleEvent` - `string id` Unique identifier for this event. - `\Datetime processedAt` A timestamp in RFC 3339 format - `StopReason stopReason` The agent completed its turn naturally and is ready for the next user message. - `Type type` - `ManagedAgentsSessionStatusTerminatedEvent` - `string id` Unique identifier for this event. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `ManagedAgentsSessionThreadCreatedEvent` - `string id` Unique identifier for this event. - `string agentName` Name of the callable agent the thread runs. - `\Datetime processedAt` A timestamp in RFC 3339 format - `string sessionThreadID` Public `sthr_` ID of the newly created thread. - `Type type` - `ManagedAgentsSpanOutcomeEvaluationStartEvent` - `string id` Unique identifier for this event. - `int iteration` 0-indexed revision cycle. 0 is the first evaluation; 1 is the re-evaluation after the first revision; etc. - `string outcomeID` The `outc_` ID of the outcome being evaluated. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `ManagedAgentsSpanOutcomeEvaluationEndEvent` - `string id` Unique identifier for this event. - `string explanation` Human-readable explanation of the verdict. For `needs_revision`, describes which criteria failed and why. - `int iteration` 0-indexed revision cycle, matching the corresponding `span.outcome_evaluation_start`. - `string outcomeEvaluationStartID` The id of the corresponding `span.outcome_evaluation_start` event. - `string outcomeID` The `outc_` ID of the outcome being evaluated. - `\Datetime processedAt` A timestamp in RFC 3339 format - `string result` 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. - `Type type` - `ManagedAgentsSpanModelUsage usage` Token usage for a single model request. - `ManagedAgentsSpanModelRequestStartEvent` - `string id` Unique identifier for this event. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `ManagedAgentsSpanModelRequestEndEvent` - `string id` Unique identifier for this event. - `?bool isError` Whether the model request resulted in an error. - `string modelRequestStartID` The id of the corresponding `span.model_request_start` event. - `ManagedAgentsSpanModelUsage modelUsage` Token usage for a single model request. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `ManagedAgentsSpanOutcomeEvaluationOngoingEvent` - `string id` Unique identifier for this event. - `int iteration` 0-indexed revision cycle, matching the corresponding `span.outcome_evaluation_start`. - `string outcomeID` The `outc_` ID of the outcome being evaluated. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `ManagedAgentsUserDefineOutcomeEvent` - `string id` Unique identifier for this event. - `string description` What the agent should produce. Copied from the input event. - `?int maxIterations` Evaluate-then-revise cycles before giving up. Default 3, max 20. - `string outcomeID` Server-generated `outc_` ID for this outcome. Referenced by `span.outcome_evaluation_*` events and the session's `outcome_evaluations` list. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Rubric rubric` Rubric for grading the quality of an outcome. - `Type type` - `ManagedAgentsSessionDeletedEvent` - `string id` Unique identifier for this event. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `ManagedAgentsSessionThreadStatusRunningEvent` - `string id` Unique identifier for this event. - `string agentName` Name of the agent the thread runs. - `\Datetime processedAt` A timestamp in RFC 3339 format - `string sessionThreadID` Public sthr_ ID of the thread that started running. - `Type type` - `ManagedAgentsSessionThreadStatusIdleEvent` - `string id` Unique identifier for this event. - `string agentName` Name of the agent the thread runs. - `\Datetime processedAt` A timestamp in RFC 3339 format - `string sessionThreadID` Public sthr_ ID of the thread that went idle. - `StopReason stopReason` The agent completed its turn naturally and is ready for the next user message. - `Type type` - `ManagedAgentsSessionThreadStatusTerminatedEvent` - `string id` Unique identifier for this event. - `string agentName` Name of the agent the thread runs. - `\Datetime processedAt` A timestamp in RFC 3339 format - `string sessionThreadID` Public sthr_ ID of the thread that terminated. - `Type type` - `BetaManagedAgentsUserToolResultEvent` - `string id` Unique identifier for this event. - `string toolUseID` The id of the `agent.tool_use` event this result corresponds to, which can be found in the last `session.status_idle` [event's](https://platform.claude.com/docs/en/api/beta/sessions/events/list#beta_managed_agents_session_requires_action.event_ids) `stop_reason.event_ids` field. - `Type type` - `?list content` The result content returned by the tool. - `?bool isError` Whether the tool execution resulted in an error. - `?\Datetime processedAt` A timestamp in RFC 3339 format - `?string sessionThreadID` Routes this result to a subagent thread. Copy from the `agent.tool_use` event's `session_thread_id`. - `ManagedAgentsSessionThreadStatusRescheduledEvent` - `string id` Unique identifier for this event. - `string agentName` Name of the agent the thread runs. - `\Datetime processedAt` A timestamp in RFC 3339 format - `string sessionThreadID` Public sthr_ ID of the thread that is retrying. - `Type type` - `BetaManagedAgentsSessionUpdatedEvent` - `string id` Unique identifier for this event. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `?BetaManagedAgentsSessionAgent agent` Resolved `agent` definition for a `session`. Snapshot of the `agent` at `session` creation time. - `?array metadata` 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. - `?string title` The session's new title. Present only when the update changed it. - `BetaManagedAgentsSystemMessageEvent` - `string id` Unique identifier for this event. - `list content` System content blocks. Text-only. - `Type type` - `?\Datetime processedAt` A timestamp in RFC 3339 format # Events ## List Session Thread Events `$client->beta->sessions->threads->events->list(string threadID, string sessionID, ?int limit, ?string page, ?list betas): PageCursor` **get** `/v1/sessions/{session_id}/threads/{thread_id}/events` List Session Thread Events ### Parameters - `sessionID: string` - `threadID: string` - `limit?:optional int` Query parameter for limit - `page?:optional string` Query parameter for page - `betas?:optional list` Optional header to specify the beta version(s) you want to use. ### Returns - `ManagedAgentsSessionEvent` - `ManagedAgentsUserMessageEvent` - `string id` Unique identifier for this event. - `list content` Array of content blocks comprising the user message. - `Type type` - `?\Datetime processedAt` A timestamp in RFC 3339 format - `ManagedAgentsUserInterruptEvent` - `string id` Unique identifier for this event. - `Type type` - `?\Datetime processedAt` A timestamp in RFC 3339 format - `?string sessionThreadID` 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. - `ManagedAgentsUserToolConfirmationEvent` - `string id` Unique identifier for this event. - `Result result` UserToolConfirmationResult enum - `string toolUseID` 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](https://platform.claude.com/docs/en/api/beta/sessions/events/list#beta_managed_agents_session_requires_action.event_ids) `stop_reason.event_ids` field. - `Type type` - `?string denyMessage` Optional message providing context for a 'deny' decision. Only allowed when result is 'deny'. - `?\Datetime processedAt` A timestamp in RFC 3339 format - `?string sessionThreadID` When set, the confirmation routes to this subagent's thread rather than the primary. Echo this from the `session_thread_id` on the `agent.tool_use` or `agent.mcp_tool_use` event that prompted the approval. - `ManagedAgentsUserCustomToolResultEvent` - `string id` Unique identifier for this event. - `string customToolUseID` 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](https://platform.claude.com/docs/en/api/beta/sessions/events/list#beta_managed_agents_session_requires_action.event_ids) `stop_reason.event_ids` field. - `Type type` - `?list content` The result content returned by the tool. - `?bool isError` Whether the tool execution resulted in an error. - `?\Datetime processedAt` A timestamp in RFC 3339 format - `?string sessionThreadID` Routes this result to a subagent thread. Copy from the `agent.custom_tool_use` event's `session_thread_id`. - `ManagedAgentsAgentCustomToolUseEvent` - `string id` Unique identifier for this event. - `array input` Input parameters for the tool call. - `string name` Name of the custom tool being called. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `?string sessionThreadID` 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. Echo this on a `user.custom_tool_result` event to route the result back. - `ManagedAgentsAgentMessageEvent` - `string id` Unique identifier for this event. - `list content` Array of text blocks comprising the agent response. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `ManagedAgentsAgentThinkingEvent` - `string id` Unique identifier for this event. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `ManagedAgentsAgentMCPToolUseEvent` - `string id` Unique identifier for this event. - `array input` Input parameters for the tool call. - `string mcpServerName` Name of the MCP server providing the tool. - `string name` Name of the MCP tool being used. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `?EvaluatedPermission evaluatedPermission` AgentEvaluatedPermission enum - `?string sessionThreadID` 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. Echo this on a `user.tool_confirmation` event to route the approval back. - `ManagedAgentsAgentMCPToolResultEvent` - `string id` Unique identifier for this event. - `string mcpToolUseID` The id of the `agent.mcp_tool_use` event this result corresponds to. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `?list content` The result content returned by the tool. - `?bool isError` Whether the tool execution resulted in an error. - `ManagedAgentsAgentToolUseEvent` - `string id` Unique identifier for this event. - `array input` Input parameters for the tool call. - `string name` Name of the agent tool being used. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `?EvaluatedPermission evaluatedPermission` AgentEvaluatedPermission enum - `?string sessionThreadID` 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. Echo this on a `user.tool_confirmation` event to route the approval back. - `ManagedAgentsAgentToolResultEvent` - `string id` Unique identifier for this event. - `\Datetime processedAt` A timestamp in RFC 3339 format - `string toolUseID` The id of the `agent.tool_use` event this result corresponds to. - `Type type` - `?list content` The result content returned by the tool. - `?bool isError` Whether the tool execution resulted in an error. - `ManagedAgentsAgentThreadMessageReceivedEvent` - `string id` Unique identifier for this event. - `list content` Message content blocks. - `string fromSessionThreadID` Public `sthr_` ID of the thread that sent the message. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `?string fromAgentName` Name of the callable agent this message came from. Absent when received from the primary agent. - `ManagedAgentsAgentThreadMessageSentEvent` - `string id` Unique identifier for this event. - `list content` Message content blocks. - `\Datetime processedAt` A timestamp in RFC 3339 format - `string toSessionThreadID` Public `sthr_` ID of the thread the message was sent to. - `Type type` - `?string toAgentName` Name of the callable agent this message was sent to. Absent when sent to the primary agent. - `ManagedAgentsAgentThreadContextCompactedEvent` - `string id` Unique identifier for this event. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `ManagedAgentsSessionErrorEvent` - `string id` Unique identifier for this event. - `Error error` An unknown or unexpected error occurred during session execution. A fallback variant; clients that don't recognize a new error code can match on `retry_status` and `message` alone. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `ManagedAgentsSessionStatusRescheduledEvent` - `string id` Unique identifier for this event. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `ManagedAgentsSessionStatusRunningEvent` - `string id` Unique identifier for this event. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `ManagedAgentsSessionStatusIdleEvent` - `string id` Unique identifier for this event. - `\Datetime processedAt` A timestamp in RFC 3339 format - `StopReason stopReason` The agent completed its turn naturally and is ready for the next user message. - `Type type` - `ManagedAgentsSessionStatusTerminatedEvent` - `string id` Unique identifier for this event. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `ManagedAgentsSessionThreadCreatedEvent` - `string id` Unique identifier for this event. - `string agentName` Name of the callable agent the thread runs. - `\Datetime processedAt` A timestamp in RFC 3339 format - `string sessionThreadID` Public `sthr_` ID of the newly created thread. - `Type type` - `ManagedAgentsSpanOutcomeEvaluationStartEvent` - `string id` Unique identifier for this event. - `int iteration` 0-indexed revision cycle. 0 is the first evaluation; 1 is the re-evaluation after the first revision; etc. - `string outcomeID` The `outc_` ID of the outcome being evaluated. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `ManagedAgentsSpanOutcomeEvaluationEndEvent` - `string id` Unique identifier for this event. - `string explanation` Human-readable explanation of the verdict. For `needs_revision`, describes which criteria failed and why. - `int iteration` 0-indexed revision cycle, matching the corresponding `span.outcome_evaluation_start`. - `string outcomeEvaluationStartID` The id of the corresponding `span.outcome_evaluation_start` event. - `string outcomeID` The `outc_` ID of the outcome being evaluated. - `\Datetime processedAt` A timestamp in RFC 3339 format - `string result` 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. - `Type type` - `ManagedAgentsSpanModelUsage usage` Token usage for a single model request. - `ManagedAgentsSpanModelRequestStartEvent` - `string id` Unique identifier for this event. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `ManagedAgentsSpanModelRequestEndEvent` - `string id` Unique identifier for this event. - `?bool isError` Whether the model request resulted in an error. - `string modelRequestStartID` The id of the corresponding `span.model_request_start` event. - `ManagedAgentsSpanModelUsage modelUsage` Token usage for a single model request. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `ManagedAgentsSpanOutcomeEvaluationOngoingEvent` - `string id` Unique identifier for this event. - `int iteration` 0-indexed revision cycle, matching the corresponding `span.outcome_evaluation_start`. - `string outcomeID` The `outc_` ID of the outcome being evaluated. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `ManagedAgentsUserDefineOutcomeEvent` - `string id` Unique identifier for this event. - `string description` What the agent should produce. Copied from the input event. - `?int maxIterations` Evaluate-then-revise cycles before giving up. Default 3, max 20. - `string outcomeID` Server-generated `outc_` ID for this outcome. Referenced by `span.outcome_evaluation_*` events and the session's `outcome_evaluations` list. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Rubric rubric` Rubric for grading the quality of an outcome. - `Type type` - `ManagedAgentsSessionDeletedEvent` - `string id` Unique identifier for this event. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `ManagedAgentsSessionThreadStatusRunningEvent` - `string id` Unique identifier for this event. - `string agentName` Name of the agent the thread runs. - `\Datetime processedAt` A timestamp in RFC 3339 format - `string sessionThreadID` Public sthr_ ID of the thread that started running. - `Type type` - `ManagedAgentsSessionThreadStatusIdleEvent` - `string id` Unique identifier for this event. - `string agentName` Name of the agent the thread runs. - `\Datetime processedAt` A timestamp in RFC 3339 format - `string sessionThreadID` Public sthr_ ID of the thread that went idle. - `StopReason stopReason` The agent completed its turn naturally and is ready for the next user message. - `Type type` - `ManagedAgentsSessionThreadStatusTerminatedEvent` - `string id` Unique identifier for this event. - `string agentName` Name of the agent the thread runs. - `\Datetime processedAt` A timestamp in RFC 3339 format - `string sessionThreadID` Public sthr_ ID of the thread that terminated. - `Type type` - `BetaManagedAgentsUserToolResultEvent` - `string id` Unique identifier for this event. - `string toolUseID` The id of the `agent.tool_use` event this result corresponds to, which can be found in the last `session.status_idle` [event's](https://platform.claude.com/docs/en/api/beta/sessions/events/list#beta_managed_agents_session_requires_action.event_ids) `stop_reason.event_ids` field. - `Type type` - `?list content` The result content returned by the tool. - `?bool isError` Whether the tool execution resulted in an error. - `?\Datetime processedAt` A timestamp in RFC 3339 format - `?string sessionThreadID` Routes this result to a subagent thread. Copy from the `agent.tool_use` event's `session_thread_id`. - `ManagedAgentsSessionThreadStatusRescheduledEvent` - `string id` Unique identifier for this event. - `string agentName` Name of the agent the thread runs. - `\Datetime processedAt` A timestamp in RFC 3339 format - `string sessionThreadID` Public sthr_ ID of the thread that is retrying. - `Type type` - `BetaManagedAgentsSessionUpdatedEvent` - `string id` Unique identifier for this event. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `?BetaManagedAgentsSessionAgent agent` Resolved `agent` definition for a `session`. Snapshot of the `agent` at `session` creation time. - `?array metadata` 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. - `?string title` The session's new title. Present only when the update changed it. - `BetaManagedAgentsSystemMessageEvent` - `string id` Unique identifier for this event. - `list content` System content blocks. Text-only. - `Type type` - `?\Datetime processedAt` A timestamp in RFC 3339 format ### Example ```php beta->sessions->threads->events->list( 'sthr_011CZkZVWa6oIjw0rgXZpnBt', sessionID: 'sesn_011CZkZAtmR3yMPDzynEDxu7', limit: 0, page: 'page', betas: ['message-batches-2024-09-24'], ); var_dump($page); ``` #### Response ```json { "data": [ { "id": "sevt_011CZkZGOp0iBcp4kaQSihUmy", "content": [ { "text": "Where is my order #1234?", "type": "text" } ], "type": "user.message", "processed_at": "2026-03-15T10:00:00Z" } ], "next_page": "next_page" } ``` ## Stream Session Thread Events `$client->beta->sessions->threads->events->stream(string threadID, string sessionID, ?list betas): ManagedAgentsStreamSessionThreadEvents` **get** `/v1/sessions/{session_id}/threads/{thread_id}/stream` Stream Session Thread Events ### Parameters - `sessionID: string` - `threadID: string` - `betas?:optional list` Optional header to specify the beta version(s) you want to use. ### Returns - `ManagedAgentsStreamSessionThreadEvents` - `ManagedAgentsUserMessageEvent` - `string id` Unique identifier for this event. - `list content` Array of content blocks comprising the user message. - `Type type` - `?\Datetime processedAt` A timestamp in RFC 3339 format - `ManagedAgentsUserInterruptEvent` - `string id` Unique identifier for this event. - `Type type` - `?\Datetime processedAt` A timestamp in RFC 3339 format - `?string sessionThreadID` 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. - `ManagedAgentsUserToolConfirmationEvent` - `string id` Unique identifier for this event. - `Result result` UserToolConfirmationResult enum - `string toolUseID` 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](https://platform.claude.com/docs/en/api/beta/sessions/events/list#beta_managed_agents_session_requires_action.event_ids) `stop_reason.event_ids` field. - `Type type` - `?string denyMessage` Optional message providing context for a 'deny' decision. Only allowed when result is 'deny'. - `?\Datetime processedAt` A timestamp in RFC 3339 format - `?string sessionThreadID` When set, the confirmation routes to this subagent's thread rather than the primary. Echo this from the `session_thread_id` on the `agent.tool_use` or `agent.mcp_tool_use` event that prompted the approval. - `ManagedAgentsUserCustomToolResultEvent` - `string id` Unique identifier for this event. - `string customToolUseID` 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](https://platform.claude.com/docs/en/api/beta/sessions/events/list#beta_managed_agents_session_requires_action.event_ids) `stop_reason.event_ids` field. - `Type type` - `?list content` The result content returned by the tool. - `?bool isError` Whether the tool execution resulted in an error. - `?\Datetime processedAt` A timestamp in RFC 3339 format - `?string sessionThreadID` Routes this result to a subagent thread. Copy from the `agent.custom_tool_use` event's `session_thread_id`. - `ManagedAgentsAgentCustomToolUseEvent` - `string id` Unique identifier for this event. - `array input` Input parameters for the tool call. - `string name` Name of the custom tool being called. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `?string sessionThreadID` 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. Echo this on a `user.custom_tool_result` event to route the result back. - `ManagedAgentsAgentMessageEvent` - `string id` Unique identifier for this event. - `list content` Array of text blocks comprising the agent response. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `ManagedAgentsAgentThinkingEvent` - `string id` Unique identifier for this event. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `ManagedAgentsAgentMCPToolUseEvent` - `string id` Unique identifier for this event. - `array input` Input parameters for the tool call. - `string mcpServerName` Name of the MCP server providing the tool. - `string name` Name of the MCP tool being used. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `?EvaluatedPermission evaluatedPermission` AgentEvaluatedPermission enum - `?string sessionThreadID` 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. Echo this on a `user.tool_confirmation` event to route the approval back. - `ManagedAgentsAgentMCPToolResultEvent` - `string id` Unique identifier for this event. - `string mcpToolUseID` The id of the `agent.mcp_tool_use` event this result corresponds to. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `?list content` The result content returned by the tool. - `?bool isError` Whether the tool execution resulted in an error. - `ManagedAgentsAgentToolUseEvent` - `string id` Unique identifier for this event. - `array input` Input parameters for the tool call. - `string name` Name of the agent tool being used. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `?EvaluatedPermission evaluatedPermission` AgentEvaluatedPermission enum - `?string sessionThreadID` 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. Echo this on a `user.tool_confirmation` event to route the approval back. - `ManagedAgentsAgentToolResultEvent` - `string id` Unique identifier for this event. - `\Datetime processedAt` A timestamp in RFC 3339 format - `string toolUseID` The id of the `agent.tool_use` event this result corresponds to. - `Type type` - `?list content` The result content returned by the tool. - `?bool isError` Whether the tool execution resulted in an error. - `ManagedAgentsAgentThreadMessageReceivedEvent` - `string id` Unique identifier for this event. - `list content` Message content blocks. - `string fromSessionThreadID` Public `sthr_` ID of the thread that sent the message. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `?string fromAgentName` Name of the callable agent this message came from. Absent when received from the primary agent. - `ManagedAgentsAgentThreadMessageSentEvent` - `string id` Unique identifier for this event. - `list content` Message content blocks. - `\Datetime processedAt` A timestamp in RFC 3339 format - `string toSessionThreadID` Public `sthr_` ID of the thread the message was sent to. - `Type type` - `?string toAgentName` Name of the callable agent this message was sent to. Absent when sent to the primary agent. - `ManagedAgentsAgentThreadContextCompactedEvent` - `string id` Unique identifier for this event. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `ManagedAgentsSessionErrorEvent` - `string id` Unique identifier for this event. - `Error error` An unknown or unexpected error occurred during session execution. A fallback variant; clients that don't recognize a new error code can match on `retry_status` and `message` alone. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `ManagedAgentsSessionStatusRescheduledEvent` - `string id` Unique identifier for this event. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `ManagedAgentsSessionStatusRunningEvent` - `string id` Unique identifier for this event. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `ManagedAgentsSessionStatusIdleEvent` - `string id` Unique identifier for this event. - `\Datetime processedAt` A timestamp in RFC 3339 format - `StopReason stopReason` The agent completed its turn naturally and is ready for the next user message. - `Type type` - `ManagedAgentsSessionStatusTerminatedEvent` - `string id` Unique identifier for this event. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `ManagedAgentsSessionThreadCreatedEvent` - `string id` Unique identifier for this event. - `string agentName` Name of the callable agent the thread runs. - `\Datetime processedAt` A timestamp in RFC 3339 format - `string sessionThreadID` Public `sthr_` ID of the newly created thread. - `Type type` - `ManagedAgentsSpanOutcomeEvaluationStartEvent` - `string id` Unique identifier for this event. - `int iteration` 0-indexed revision cycle. 0 is the first evaluation; 1 is the re-evaluation after the first revision; etc. - `string outcomeID` The `outc_` ID of the outcome being evaluated. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `ManagedAgentsSpanOutcomeEvaluationEndEvent` - `string id` Unique identifier for this event. - `string explanation` Human-readable explanation of the verdict. For `needs_revision`, describes which criteria failed and why. - `int iteration` 0-indexed revision cycle, matching the corresponding `span.outcome_evaluation_start`. - `string outcomeEvaluationStartID` The id of the corresponding `span.outcome_evaluation_start` event. - `string outcomeID` The `outc_` ID of the outcome being evaluated. - `\Datetime processedAt` A timestamp in RFC 3339 format - `string result` 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. - `Type type` - `ManagedAgentsSpanModelUsage usage` Token usage for a single model request. - `ManagedAgentsSpanModelRequestStartEvent` - `string id` Unique identifier for this event. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `ManagedAgentsSpanModelRequestEndEvent` - `string id` Unique identifier for this event. - `?bool isError` Whether the model request resulted in an error. - `string modelRequestStartID` The id of the corresponding `span.model_request_start` event. - `ManagedAgentsSpanModelUsage modelUsage` Token usage for a single model request. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `ManagedAgentsSpanOutcomeEvaluationOngoingEvent` - `string id` Unique identifier for this event. - `int iteration` 0-indexed revision cycle, matching the corresponding `span.outcome_evaluation_start`. - `string outcomeID` The `outc_` ID of the outcome being evaluated. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `ManagedAgentsUserDefineOutcomeEvent` - `string id` Unique identifier for this event. - `string description` What the agent should produce. Copied from the input event. - `?int maxIterations` Evaluate-then-revise cycles before giving up. Default 3, max 20. - `string outcomeID` Server-generated `outc_` ID for this outcome. Referenced by `span.outcome_evaluation_*` events and the session's `outcome_evaluations` list. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Rubric rubric` Rubric for grading the quality of an outcome. - `Type type` - `ManagedAgentsSessionDeletedEvent` - `string id` Unique identifier for this event. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `ManagedAgentsSessionThreadStatusRunningEvent` - `string id` Unique identifier for this event. - `string agentName` Name of the agent the thread runs. - `\Datetime processedAt` A timestamp in RFC 3339 format - `string sessionThreadID` Public sthr_ ID of the thread that started running. - `Type type` - `ManagedAgentsSessionThreadStatusIdleEvent` - `string id` Unique identifier for this event. - `string agentName` Name of the agent the thread runs. - `\Datetime processedAt` A timestamp in RFC 3339 format - `string sessionThreadID` Public sthr_ ID of the thread that went idle. - `StopReason stopReason` The agent completed its turn naturally and is ready for the next user message. - `Type type` - `ManagedAgentsSessionThreadStatusTerminatedEvent` - `string id` Unique identifier for this event. - `string agentName` Name of the agent the thread runs. - `\Datetime processedAt` A timestamp in RFC 3339 format - `string sessionThreadID` Public sthr_ ID of the thread that terminated. - `Type type` - `BetaManagedAgentsUserToolResultEvent` - `string id` Unique identifier for this event. - `string toolUseID` The id of the `agent.tool_use` event this result corresponds to, which can be found in the last `session.status_idle` [event's](https://platform.claude.com/docs/en/api/beta/sessions/events/list#beta_managed_agents_session_requires_action.event_ids) `stop_reason.event_ids` field. - `Type type` - `?list content` The result content returned by the tool. - `?bool isError` Whether the tool execution resulted in an error. - `?\Datetime processedAt` A timestamp in RFC 3339 format - `?string sessionThreadID` Routes this result to a subagent thread. Copy from the `agent.tool_use` event's `session_thread_id`. - `ManagedAgentsSessionThreadStatusRescheduledEvent` - `string id` Unique identifier for this event. - `string agentName` Name of the agent the thread runs. - `\Datetime processedAt` A timestamp in RFC 3339 format - `string sessionThreadID` Public sthr_ ID of the thread that is retrying. - `Type type` - `BetaManagedAgentsSessionUpdatedEvent` - `string id` Unique identifier for this event. - `\Datetime processedAt` A timestamp in RFC 3339 format - `Type type` - `?BetaManagedAgentsSessionAgent agent` Resolved `agent` definition for a `session`. Snapshot of the `agent` at `session` creation time. - `?array metadata` 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. - `?string title` The session's new title. Present only when the update changed it. - `BetaManagedAgentsSystemMessageEvent` - `string id` Unique identifier for this event. - `list content` System content blocks. Text-only. - `Type type` - `?\Datetime processedAt` A timestamp in RFC 3339 format ### Example ```php beta ->sessions ->threads ->events ->streamStream( 'sthr_011CZkZVWa6oIjw0rgXZpnBt', sessionID: 'sesn_011CZkZAtmR3yMPDzynEDxu7', betas: ['message-batches-2024-09-24'], ); var_dump($betaManagedAgentsStreamSessionThreadEvents); ``` #### Response ```json { "id": "sevt_011CZkZGOp0iBcp4kaQSihUmy", "content": [ { "text": "Where is my order #1234?", "type": "text" } ], "type": "user.message", "processed_at": "2026-03-15T10:00:00Z" } ```