Docs
DashboardGet API key
API · inboxes

Delete an inbox

Remove a receive address. Allowed only while the inbox is empty — once it has received mail, its threads are kept.

DELETE/v1/inboxes/{id}

01 Path parameters

idstringRequired
The inbox id to delete, for example inb_01HZ9C7R2K.

02 Request

curl -X DELETE https://api.drin.run/v1/inboxes/inb_01HZ9C7R2K \
  -H "Authorization: Bearer $DRIN_API_KEY"

03 Response

204 No Content on success — there is no response body.

409 on existing messagesAn inbox that has received mail cannot be deleted — the request is refused with 409 Conflict so the conversation history is preserved. Disable receiving on the domain to stop new mail instead.
JSON
{
  "error": {
    "type": "conflict",
    "message": "Inbox has messages and cannot be deleted."
  }
}