# Delete an inbox (/docs/api-reference/inboxes/delete-inbox)

Deletes the inbox and its threads. The received emails and emails they held stay in the environment until their retention ends, and mail to the address is still received by the environment (without a thread or `inbox.message.received` webhook).

`DELETE https://api.coss.com/v1/inboxes/{inbox_id}`

Authenticate with your API key as a bearer token (`Authorization: Bearer coss_test_…`). Responses are JSON with snake_case fields; errors are `{ error: { type, code, message, param?, issues?, request_id } }` (https://coss.com/docs/api-reference/errors.md).

## Path parameters

- `inbox_id` (string, required): The inbox's id.

## Example request

TypeScript (the `coss` package):

```ts
import { Coss } from "coss";

const coss = new Coss({
  apiKey: process.env.COSS_API_KEY,
  baseUrl: "https://api.coss.com",
});

const { data, error } = await coss.inboxes.delete("inbox_01k7c8m4q2f3e9v6t5r1n0p8yz");
```

HTTP:

```sh
curl -X DELETE "https://api.coss.com/v1/inboxes/inbox_01k7c8m4q2f3e9v6t5r1n0p8yz" \
  -H "Authorization: Bearer $COSS_API_KEY"
```

## Response 200

The inbox was deleted.

- `object` ("inbox", required)
- `id` (string, required)
- `deleted` (true, required)

Example:

```json
{
  "object": "inbox",
  "id": "inbox_01k7c8m4q2f3e9v6t5r1n0p8yz",
  "deleted": true
}
```

## Errors

- `400`: The `Coss-Version` header names an unknown API version (`invalid_api_version`).
- `401`: The API key is missing, invalid, revoked or expired (`authentication_error`).
- `403`: The API key lacks the permission this endpoint needs (`permission_error`), or its organization is suspended (`organization_suspended`).
- `404`: No inbox with this id exists in this environment. (`not_found`)
- `429`: Too many requests with this API key (`rate_limited`), or too many requests with invalid keys from this address (`too_many_failed_authentications`). Retry after `Retry-After` seconds. Successful responses carry `RateLimit-Limit`, `RateLimit-Remaining` and `RateLimit-Reset` (seconds until the limit is fully restored).
- `500`: Unexpected server error (`api_error` / `internal_error`).
- `503`: The API key could not be verified right now; retry (`service_unavailable`).