# `bird email threads`

## Usage

```bash
bird email threads
```

## Description

Read and reply to the email conversation threads across your mailboxes. A thread
groups all the messages in one conversation, newest first.

list returns threads across all mailboxes (filter by mailbox, contact, label, or
time); get returns a single thread. Use messages to list, read, or reply to
individual messages in a thread. Threads are deleted by id; pass --permanent to
skip the trash window.

Reads return JSON; list is paginated. Mutations take flags and/or a --body-file JSON body (flags overriding); run --example to print the body shape or --dry-run to preview the request. Destructive commands require --yes.

## Commands

| Name                                                     | Description                            |
| -------------------------------------------------------- | -------------------------------------- |
| [`delete`](/docs/cli/reference/email-threads-delete)     | Delete a thread                        |
| [`get`](/docs/cli/reference/email-threads-get)           | Get a thread                           |
| [`list`](/docs/cli/reference/email-threads-list)         | List threads                           |
| [`messages`](/docs/cli/reference/email-threads-messages) | Read and reply to messages in a thread |
| [`update`](/docs/cli/reference/email-threads-update)     | Update a thread                        |