---
title: "Delete a mailbox"
canonical: "https://bird.com/docs/api/reference/delete-mailbox"
---

# Delete a mailbox

`DELETE /v1/email/mailboxes/{mailbox_id}`

Deletes a mailbox. The address stops receiving mail immediately and enters quarantine. After 30 days, your workspace can bind the address to a new mailbox; the address remains reserved to your workspace. You can restore the mailbox for 30 days with `POST /email/mailboxes/{mailbox_id}/restore`. Normal message-retention expiry continues during that period. After 30 days, the mailbox and its remaining messages are permanently deleted. Returns `409` (`E01028`) if an enabled inbound route targets the mailbox. Disable, delete, or redirect those routes before retrying.

## Code samples

**TypeScript**

```ts
await bird.email.mailboxes.delete("mbx_01abc");
```

Examples: [TypeScript](/docs/api/reference/delete-mailbox.ts.md) · [Python](/docs/api/reference/delete-mailbox.py.md) · [Go](/docs/api/reference/delete-mailbox.go.md) · [PHP](/docs/api/reference/delete-mailbox.php.md) · [CLI](/docs/api/reference/delete-mailbox.cli.md) · [MCP](/docs/api/reference/delete-mailbox.mcp.md) · [cURL](/docs/api/reference/delete-mailbox.curl.md)

## Path parameters

- `mailbox_id` (string): Mailbox identifier. Starts with `mbx_`.

## Related resources

- [Setting up your coding agent](/learn/basics/setting-up-your-coding-agent) (video)
- [What is an MCP server, and how does an agent use one to send messages?](/explained/platform/what-is-an-mcp-server-and-how-does-an-agent-send-messages) (answer)
- [Coding agents](/ai) (product)
- [Build with AI agents](/learn/paths/agents) (course)

[Get an implementation brief](/learn/workspace?topic=agents)