> ## 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.

# Delete Inbox

> DELETE /v1/email/inboxes/:id — Deactivate an email inbox (soft delete).

<ParamField path="id" type="string" required>
  UUID of the inbox to delete
</ParamField>

<RequestExample>
  ```bash theme={"theme":"css-variables"}
  curl -X DELETE https://api.usenaive.ai/v1/email/inboxes/550e8400-e29b-41d4-a716-446655440000 \
    -H "Authorization: Bearer nv_sk_live_..."
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={"theme":"css-variables"}
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "address": "support@acme-corp.ai",
    "status": "deleted"
  }
  ```
</ResponseExample>

## 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

| Status | Code                 | When                                           |
| ------ | -------------------- | ---------------------------------------------- |
| 404    | `resource_not_found` | Inbox not found, not owned, or already deleted |

## CLI

```bash theme={"theme":"css-variables"}
naive email delete <inbox-uuid>
```

## MCP

Tool: `naive_delete_inbox`

```json theme={"theme":"css-variables"}
{
  "inbox_id": "550e8400-e29b-41d4-a716-446655440000"
}
```