DELETE/emails/scheduled/{id}

DELETE /emails/scheduled/{id}

Cancel an email scheduled with sendAt, before it fires.

View as Markdown

Request

curl -X DELETE 'https://api.sendheron.com/api/v1/emails/scheduled/{id}' \
  -H 'Authorization: Bearer <YOUR_API_KEY>' \
  -H 'Content-Type: application/json'

Required scopes

The key must carry these:

  • emails:send

Path parameters

NameTypeRequiredDescription
iduuidYesThe scheduled email's UUID, returned by the send that scheduled it.

Responses

Returns 200 on success.

400
The payload failed validation, or the request is not valid for the current state.
401
Missing or invalid API key.
403
Valid key, but it does not carry the required scope.
404
No such record in this workspace.
409
A duplicate, or an idempotency key reused with a different payload.
429
Either rate-limit ceiling was exceeded.

Rate limits

100/min per key, counted against the organization's WRITE ceiling (400/min). Both windows are one minute. There is no hourly or daily quota.