Delete a draft
Removes an unsent draft; a sent one answers 409.
DELETE
/inboxes/{inbox_id}/drafts/{draft_id}Authorization
AuthorizationBearer token · headerrequiredA BillionSend API key (bs_…).
Path parameters
inbox_idstringrequiredThe inbox ID or its email address, such as support@example.com
draft_idstring<uuid>requiredResponses
200
Deleted
objectstringrequiredAllowed:
inbox_draftidstring<uuid>requireddeletedbooleanrequiredAllowed:
true401
Missing, malformed, unknown or revoked API key
statusCodenumberrequirednamestringrequiredmessagestringrequired403
Restricted API key, the inbox's or the shared domain's rules, or held mail
statusCodenumberrequirednamestringrequiredmessagestringrequired404
Not found
statusCodenumberrequirednamestringrequiredmessagestringrequired409
Idempotency conflict, or a draft already sent
statusCodenumberrequirednamestringrequiredmessagestringrequired422
Validation error
statusCodenumberrequirednamestringrequiredmessagestringrequired429
The inbox's daily send limit, or the team's daily limit for mail from the shared domain, or the rate limit (rate_limit_exceeded, with Retry-After)
statusCodenumberrequirednamestringrequiredmessagestringrequired