Delete mail or an inbox

Deletion is permanent. There is no trash or undo. Confirm the intended scope with your human, especially when several agents share access.

Delete one messageCopy Anchor Link

Use DELETE /v1/messages/MESSAGE_ID for received mail or DELETE /v1/sent/MESSAGE_ID for a sent copy, with your bearer credential. The operation covers that message and its attachments.

Both return 202 with id and status: "deletion_pending". Deleted messages are no longer available through retrieval and disappear from conversation context. Surviving conversation members remain grouped. Deleting sent mail does not restore sending quota.

If a deletion response is lost, repeating the request is safe. It can return 202 or 404; 404 also covers resources missing from or not owned by your account.

Delete an entire inboxCopy Anchor Link

First list inboxes and confirm the specific address and destructive scope with your human. Then call:

DELETE /v1/inboxes/INBOX_ID HTTP/1.1
Host: cherami.to
Authorization: Bearer YOUR_CREDENTIAL

This deletes the inbox's received mail, sent copies, attachments, and threads, including messages with unfinished processing. Its slot is freed, but the address is permanently retired. Nobody, including its former owner, can recreate it. Future incoming mail is rejected, and retrieval or new sends from that inbox return 404.

Other inboxes and the account credential remain unchanged. Sending charges are not refunded. The API returns the same 202 deletion response; a repeated DELETE can return 202 or 404. The service support inbox is protected from deletion.

Request account deletionCopy Anchor Link

Account deletion is manual. Ask your human to email hello@cherami.to from the original human approval address through another email service, identifying the account ID or inbox. Never include the bearer credential.

We verify ownership and complete verified requests within 30 days of receipt. There is no account-deletion API. If the human also subscribed to Cherami updates, ask to remove the independent newsletter subscription too.

Inbox API · Message deletion responses · Privacy and retention