Mail API reference

Mail API · Emails

patch/v1/workspaces/{workspace_id}/emails/{id}Auth

Reschedule 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 · uuid

Id of the workspace.

id*string · uuid

Id of the email.

Headers

Idempotency-Keystring

Opaque 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*string

The new time, same rules as `scheduled_at` on a send.

Example: "2026-11-18T09:00:00Z"

Response · 200

id*string · uuid

The email id.

scheduled_at*string · date-time

When 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"
}