Skip to main content
id
string
required
UUID of the inbox to delete
curl -X DELETE https://api.usenaive.ai/v1/email/inboxes/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer nv_sk_live_..."
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "address": "support@acme-corp.ai",
  "status": "deleted"
}

What this does

  1. Verifies the inbox belongs to your company and is currently active
  2. Marks the inbox as inactive (soft delete)
  3. Emails sent to this address will no longer be routed to your company

Notes

  • This is a soft delete — the address slot is freed and can be reclaimed
  • Emails already received remain accessible via GET /v1/email/inbox
  • To recreate the same address later, use POST /v1/email/inboxes with the same local_part

Error responses

StatusCodeWhen
404resource_not_foundInbox not found, not owned, or already deleted

CLI

naive email delete <inbox-uuid>

MCP

Tool: naive_delete_inbox
{
  "inbox_id": "550e8400-e29b-41d4-a716-446655440000"
}