Ask a human before sending
request_approvalAsk a person to approve sending large, unusual, or irreversible emails; nothing is sent and no budget is spent until the pending action is reviewed.
Instructions
Purpose: ask a person before sending. Reach for it when a send is large, unusual, irreversible, or something you were told to check first. NOT for: sending. NOTHING IS SENT and no budget is spent. No tool approves one, including this one. Returns: the action id, state pending, sent: false, and where a person decides it. list_agent_actions is how you hear the answer. A payload that would be refused anyway is refused here rather than queued, so nobody is asked to approve a send that cannot succeed.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"from": "<from>",
"to": "<to>",
"subject": "<subject>",
"reason": "<reason>"
},
"name": "request_approval"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | One recipient address, or a list of up to 50. A bare string is fine. | |
| from | Yes | Sender address, e.g. "Acme <hello@acme.com>". | |
| html | No | HTML body. Provide html or text. | |
| text | No | Plain-text body. Provide html or text. | |
| reason | Yes | Why a person should look at this. Shown on the approval card. | |
| subject | Yes | Subject line. | |
| idempotency_key | No | Your own key for this action. Retrying with the same key returns the first result instead of doing it twice — send one whenever a retry could double the effect. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sent | No | Always false: asking sends nothing. | |
| error | No | Present instead of the fields above when the call was refused: code, message, fix, docs_url, retryable and, when waiting helps, retry_after_seconds. | |
| state | No | ||
| action_id | No | Identifier. | |
| check_with | No | How to hear the decision. | |
| created_at | No | ISO 8601 time. | |
| decided_by_human_at | No | Where a person decides it. |