/v1/workspaces/{workspace_id}/emails/{id}AuthReschedule a scheduled email
Moves a scheduled email (sent with `scheduled_at`) to a new time, for every recipient. Same rules as `scheduled_at`: 1 minute to 7 days ahead. Only while it is still scheduled.
Path parameters
workspace_id*string · uuidId of the workspace.
id*string · uuidId of the email.
Headers
Idempotency-KeystringOpaque client-generated string (1–256 chars, `[A-Za-z0-9._:-]`) used to deduplicate retries within a 24h window. A retry with the same key and body returns the original response with `Idempotent-Replay: true`.
Request body
scheduled_at*stringThe new time, same rules as `scheduled_at` on a send.
Example: "2026-11-18T09:00:00Z"
Response · 200
id*string · uuidThe email id.
scheduled_at*string · date-timeWhen it goes out.
Example
Request
PATCH https://api.mail.productcraft.co/v1/workspaces/{workspace_id}/emails/{id}
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json
{
"scheduled_at": "2026-11-18T09:00:00Z"
}Response
{
"id": "00000000-0000-0000-0000-000000000000",
"scheduled_at": "2026-01-01T00:00:00.000Z"
}