approval.required
⚠️
Preview — this feature is being built; the design below is the spec.
Received on the stream and in the event list. A tool on the agent’s approval list wants to run.
Example
id: evt_01JC7M3B
data: {"type": "approval.required", "tool_call_id": "call_9", "name": "issue_refund", "arguments": {"order_id": "88123", "amount": "49.00"}}Fields
| Field | Meaning |
|---|---|
arguments | Exactly what will run if you approve. |
Handling
Show the arguments to a person and send user.approval. Rejections can carry a reason the agent sees.
Was this page helpful?