Skip to Content
Docs

Reschedule a queued or scheduled send

PATCH
/v1/email/{id}

Requires Action::Manage (a full_access key) — not available to a sending_access key.

Authorization

bearerAuth
headerAuthorizationBearer <token>

API key sent as Authorization: Bearer <key>. Looked up by SHA-256 hash (email_core::sha256_hex) against api_keys.hash; revoked keys and keys belonging to a suspended tenant are rejected. See the top-level Authentication section for permission levels.

Path Parameters

id*string

The message id returned by POST /v1/email(/batch).

Request Body

application/json
  1. body
scheduled_at*integer

Epoch milliseconds; must be in the future.

Formatint64

Response Body

Rescheduled.

application/json
  1. response
message_id?string
status?"scheduled"
Value in"scheduled"
scheduled_at?integer
Formatint64
Example Request
curl -X PATCH 'https://api.emitd.com/v1/email/string' \  -H 'Content-Type: application/json' \  -d '{  "scheduled_at": 0}'
Example Response
{  "message_id": "string",  "status": "scheduled",  "scheduled_at": 0}