Skip to main content
POST
Submit Agent Session Tool Outputs

Path Parameters

session_id
string
required

Body

application/json

Persist resolved client tool outputs without continuing the turn.

toolOutputs
(ToolOutputAvailablePart · object | ToolOutputErrorPart · object | DynamicToolOutputAvailablePart · object | DynamicToolOutputErrorPart · object)[]
required

Client tool results for pending calls on the trailing assistant message, matched by toolCallId. Resending a persisted output verbatim is a no-op; an output that differs from the persisted result or matches no call is rejected with HTTP 409 and code agent_session_tool_outputs_conflict.

Minimum array length: 1

Tool part in output-available state.

lastMessageId
string
required

The trailing assistant message's id. On mismatch the submission is rejected with HTTP 409 and code agent_session_messages_stale.

Response

Successful Response

The trailing assistant message with the submitted outputs applied.

data
PhoenixUIMessage · object
required

UIMessage with metadata narrowed to the Phoenix wire shapes.