Delete an email inbox

DELETE 
/api/v1/emailInbox/:id

Soft-deletes the inbox and its messages in one transaction. The rows are retained and every read filters them out, so the data is recoverable — but the address is retired permanently and can never be claimed again, by anyone including you. Mail keeps being delivered to it, so releasing it would hand the next claimant your still-arriving messages. Requires API key with email_inboxes:delete scope, which is granted separately from create and update for exactly this reason.

Request

Responses

204

Inbox deleted. No body — the record is no longer readable.

401

Unauthorized - missing or invalid API key

403

Forbidden - API key lacks the email_inboxes:delete scope. Holding create and update does not grant it.

404

Not found - no such inbox, or it is not one this key may delete. Deliberately indistinguishable.