Delete Inbox

curl -X DELETE https://api.daimon.email/v1/inboxes/inb_abc123def456 \
  -H "Authorization: Bearer dm_free_7d8a9b0c1d2e3f4g5h6i7j8k9l0m1n2o"

import { DaimonClient } from 'daimon-email';

// Initialize with inbox-scoped API key
const client = new DaimonClient({
  apiKey: 'dm_free_7d8a9b0c1d2e3f4g5h6i7j8k9l0m1n2o'
});

const result = await client.inboxes.delete('inb_abc123def456');

console.log(`Inbox ${result.id} deleted at ${result.deletedAt}`);
console.log(`Status: ${result.status}`);

from daimon_email import DaimonClient

# Initialize with inbox-scoped API key
client = DaimonClient(
    api_key="dm_free_7d8a9b0c1d2e3f4g5h6i7j8k9l0m1n2o"
)

result = client.inboxes.delete('inb_abc123def456')

print(f"Inbox {result.id} deleted at {result.deleted_at}")
print(f"Status: {result.status}")

{
  "result": {
    "id": "inb_abc123def456",
    "status": "deleted",
    "deleted_at": "2026-03-16T17:00:00Z"
  },
  "next_steps": [
    "The inbox has been marked as deleted",
    "The email address 'my-agent@daimon.email' is now available for re-use",
    "All messages and threads are retained for compliance/recovery",
    "The API key for this inbox is now invalid"
  ]
}

{
  "error": "INVALID_API_KEY",
  "message": "The provided API key does not have access to this inbox",
  "next_steps": [
    "Verify you are using the correct inbox-scoped API key",
    "Ensure the API key has not been revoked"
  ]
}

{
  "error": "INBOX_NOT_FOUND",
  "message": "No inbox found with ID 'inb_abc123def456'",
  "next_steps": [
    "Verify the inbox ID is correct",
    "The inbox may have already been deleted"
  ]
}

{
  "error": "INBOX_ALREADY_DELETED",
  "message": "This inbox was already deleted on 2026-03-16T17:00:00Z",
  "next_steps": [
    "The inbox is already marked as deleted",
    "No further action is needed"
  ]
}