Discard a draft

DELETE/api/v1/mailbox/messages/draft/{message_id}
Requires amailbox token— it acts as one mailbox holder, not as the organization.

Permanently removes a draft. Allowed outside Trash because a draft the author just discarded was never delivered mail.

Parameters

NameInTypeDescription
message_idrequiredpathstring

Request

DELETE/api/v1/mailbox/messages/draft/{message_id}
curl -X DELETE 'https://app.mailyte.com/api/v1/mailbox/messages/draft/01JBT8XQ2M9WYC3K4F6R7S8T9V' \
  -H 'Authorization: Bearer MAILBOX_TOKEN'
The key names its own organization, so no X-Organization-ID header is needed.

Response

Successful Response

Returned inside the standard envelope.

Errors

StatusWhen
422Validation Error

Every status, with what causes it and what to do, is on the error reference.