user.approval
⚠️
Preview — this feature is being built; the design below is the spec.
Sent by you with Send events. Approve or reject a tool call that needs approval.
Example
{
"events": [
{
"type": "user.approval",
"tool_call_id": "call_9",
"decision": "reject",
"reason": "Refunds over $40 need a manager."
}
]
}Fields
| Field | Meaning |
|---|---|
decision | approve or reject. |
reason | Optional; shown to the agent on rejection. |
Handling
A rejection is not an error: the agent continues with the reason as context.
Was this page helpful?