Cancel a scheduled or queued email
cancel_emailStop a scheduled or queued email before it is sent and return its message ID with the new status; use it only for unsent mail, not sent history.
Instructions
Purpose: stop a message that has not gone out yet — scheduled or still queued. NOT for: recalling sent mail. Already-sent mail is history, and the refusal names the status it is actually in. Returns: the message id and its new status. A cancel is not the end: reschedule_email can revive a canceled message.
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": {
"email_id": "<email_id>"
},
"name": "cancel_email"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| email_id | Yes | The message id returned by send_email. | |
| 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 |
|---|---|---|---|
| id | No | Identifier. | |
| 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. | |
| status | No | The message status. |