# Delete a thread

`DELETE /v1/email/threads/{thread_id}`

Moves the conversation and all of its messages to the trash. Trashed messages are permanently deleted after 30 days, or sooner if the mailbox's retention period ends first. Pass `permanent=true` to permanently delete the conversation and its messages immediately.

## Code samples

**TypeScript**

```ts
await bird.email.threads.delete("thr_01abc", { permanent: true });
```

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

## Path parameters

- `thread_id` (string): Thread identifier. Starts with `thr_`.

## Query parameters

- `permanent` (boolean): Permanently delete the conversation and its messages immediately instead of moving them to the trash.

## Related resources

- [Getting started with email](/learn/email/getting-started-with-email) (video)
- [Email](/email-api) (product)
- [Build your first integration](/learn/paths/integration) (course)
- [Send your first email](/docs/get-started/send-your-first-email) (docs)

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