Skip to main content
Remove a receive address. Allowed only while the inbox is empty — once it has received mail, its threads are kept. DELETE /v1/inboxes/{id}

​
Path parameters

​
id
string
required
The inbox id to delete, for example inb_01HZ9C7R2K.

​
Request

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

​
Response

204 No Content on success — there is no response body.
409 on existing messages. An 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.
{
  "error": {
    "type": "conflict",
    "message": "Inbox has messages and cannot be deleted."
  }
}