# `bird email templates delete`

## Usage

```bash
bird email templates delete <template-ref> [flags]
```

## Description

Delete a template and every version it holds, freeing its slug for reuse in the workspace. There is no undo, and a later send naming the template is rejected. A template still referenced by a broadcast that has not finished sending cannot be deleted and returns a conflict.

This is destructive and cannot be undone; pass --yes to confirm.

## Examples

```bash
bird email templates delete <id> --yes
```

## Options

#### Safety

| Name                | Description                                                    |
| ------------------- | -------------------------------------------------------------- |
| `--idempotency-key` | Deduplication key; a retry with the same key won't act twice   |
| `--yes`             | Confirm a destructive action (required; the CLI never prompts) |

## Related

| Name                                                                              | Description                                           |
| --------------------------------------------------------------------------------- | ----------------------------------------------------- |
| [`bird email templates create`](/docs/cli/reference/email-templates-create)       | Create an email template and its first editable draft |
| [`bird email templates duplicate`](/docs/cli/reference/email-templates-duplicate) | Duplicate an email template                           |
| [`bird email templates get`](/docs/cli/reference/email-templates-get)             | Get an email template                                 |
| [`bird email templates list`](/docs/cli/reference/email-templates-list)           | List email templates                                  |
| [`bird email templates preview`](/docs/cli/reference/email-templates-preview)     | Render a template with sample values                  |
| [`bird email templates update`](/docs/cli/reference/email-templates-update)       | Update an email template                              |