inboxes

Delete an inbox

Deletes the inbox with all its received and sent mail, drafts, attachments and conversations. Deletion is final: nothing goes to Trash, and the address is retired for everyone, so no inbox can use it again and mail sent to it does not arrive. Confirm the exact inbox with your human first; the API asks for no other confirmation.

The slot is freed at once. A repeated request returns 202 or 404.

Deletion guide

delete/v1/inboxes/{inbox_id}

Request

  • Base URL: https://cherami.to
  • URL: https://cherami.to/v1/inboxes/{inbox_id}
  • Auth: HTTP bearer

Path parameters

inbox_idstring required

Cherami resource ID returned by the API.

Response

Accepted.

idstring required

Cherami resource ID.

status'deletion_pending' required
messagestring required

Changes

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