emails

Move an email to a new time.

Works from scheduled AND canceled — a cancel is never terminal.

post/emails/{id}/reschedule

Request

  • Base URL: https://api.agentisend.com
  • URL: https://api.agentisend.com/emails/{id}/reschedule
  • Auth: HTTP bearer

Path parameters

idstring uuid required

Headers

Idempotency-Keystring

Makes this call safe to retry. Send the same key with the same body and the original response is replayed instead of the work happening twice. Keys are 1-256 characters and are remembered for 7 days. While the first attempt is still running, a second call with that key returns 409 idempotency_in_flight (Resend calls this concurrent_idempotent_requests); the same key with a different body returns 409 idempotency_payload_mismatch (Resend: invalid_idempotent_request). Resend-Idempotency-Key is accepted as the same header.

Resend-Idempotency-Keystring

Alias of Idempotency-Key. Idempotency-Key wins if both are sent.

Request body

scheduled_atstring

ISO 8601 or a short phrase ("in 1 hour", "tomorrow 9am"). Max 30 days ahead.

scheduledAtstring

Resend Node SDK name for scheduled_at.

timezonestring

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.

Response

Success

idstring uuid required
statusstring required
scheduled_atstring required

Changes

No recorded changes to this operation across all 1 revision of this API.