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}

Path parameters

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"

import { DrinClient } from "@drin00/sdk";

const drin = new DrinClient({ apiKey: process.env.DRIN_API_KEY });

await drin.inboxes.delete("inb_01HZ9C7R2K");

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."
  }
}

Overview

Emails

Domains

Inboxes

Threads

Inbound

Webhooks

Suppressions

Contacts

Templates

Metrics

API keys

Delete an inbox

Path parameters

Request

Response

​Path parameters

​Request

​Response

Path parameters

Request

Response