user.tool_result
⚠️
Preview — this feature is being built; the design below is the spec.
Sent by you with Send events. Return the result of a tool your code ran.
Example
{
"events": [
{
"type": "user.tool_result",
"tool_call_id": "call_7",
"content": "{\"status\": \"delivered\", \"date\": \"2026-11-03\"}",
"is_error": false
}
]
}Fields
| Field | Meaning |
|---|---|
tool_call_id | From tool_call.started. |
is_error | Mark failures so the model can react. |
Handling
Send one result for every pending client call; 409 tool_call_not_pending if the call is not waiting.
Was this page helpful?