emails

Cancel many emails at once: by explicit ids or every scheduled/queued email before a time.

post/emails/bulk-cancel

Request

  • Base URL: https://api.agentisend.com
  • URL: https://api.agentisend.com/emails/bulk-cancel
  • Auth: HTTP bearer

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

idsstring[]

Messages to cancel. At most 500.

beforestring date-time

Cancel scheduled and queued messages accepted before this time.

Response

Success

canceledstring[] required

Changes

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