Submit client-side tool results
POST /v1/sessions/{session_id}/tool-results
POST
/v1/sessions/{session_id}/tool-results
Accepts tool results executed by the client and resumes the agent workflow.
Session must be in waiting_for_tool_results status.
Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ” session_id
required
string
Session ID (prefixed, e.g., session_…)
Request Body required
Section titled “Request Body required ”Request to submit client-side tool results
object
tool_results
required
Tool results from the client
Array<object>
A single tool result from the client
object
error
Error message if the tool failed
string | null
result
Result value (JSON). Null if the tool failed.
tool_call_id
required
Tool call ID (correlates with the tool call from tool.call_requested event)
string
Responses
Section titled “ Responses ”Tool results accepted and workflow resumed
Response from submitting tool results
object
accepted
required
Number of tool results accepted
integer
status
required
Session status after submission
string
Invalid session ID or request
Session not found
Session not in waiting_for_tool_results state
Internal server error