# `bird email cancel`

## Usage

```bash
bird email cancel <message-id> [flags]
```

## Description

Cancel a scheduled email before it sends. Only works while the message is still scheduled (status `scheduled`); once it starts sending — or was already canceled — the call returns a conflict error. Canceling does not return consumed scheduled-send quota.

## Examples

```bash
bird email cancel <id>
```

## Options

| Name                | Description                                                  |
| ------------------- | ------------------------------------------------------------ |
| `--idempotency-key` | Deduplication key; a retry with the same key won't act twice |

## Related

| Name                                                            | Description                                 |
| --------------------------------------------------------------- | ------------------------------------------- |
| [`bird email content`](/docs/cli/reference/email-content)       | Get stored message content                  |
| [`bird email get`](/docs/cli/reference/email-get)               | Get a message                               |
| [`bird email list`](/docs/cli/reference/email-list)             | List messages                               |
| [`bird email recipients`](/docs/cli/reference/email-recipients) | List recipients of a message                |
| [`bird email send`](/docs/cli/reference/email-send)             | Send an email message.                      |
| [`bird email send-batch`](/docs/cli/reference/email-send-batch) | Send a batch of email messages in one call. |