Move an email to a new time
reschedule_emailMove a scheduled or canceled message to a new send time; sent or failed emails are refused by status.
Instructions
Purpose: move a scheduled — or canceled — message to a new send time. NOT for: a settled message. Sent, bounced, failed, complained and suppressed cannot be moved, and the refusal names the status. Returns: the message id, its status and the new scheduled time.
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>",
"scheduled_at": "<scheduled_at>"
},
"name": "reschedule_email"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| email_id | Yes | The message id returned by send_email. | |
| timezone | No | Time zone for a scheduled_at phrase such as "tomorrow 9am". An ISO time ignores this. Example: America/Los_Angeles. Omitted phrases are read in UTC. | |
| scheduled_at | Yes | The same field PATCH /emails/:id takes: ISO 8601 ("2026-09-05T09:00:00Z") or a short phrase ("in 1 hour", "tomorrow 9am", "friday 14:00"), within the next 30 days. "now" sends it straight away; a time in the past is refused. | |
| 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 | ||
| scheduled_at | No | ISO 8601 time. |