Skip to main content

Documentation Index

Fetch the complete documentation index at: https://usenaive.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

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