# `bird email templates`

## Usage

```bash
bird email templates
```

## Description

A template owns a permanent handle and one editable draft. Editing the draft never
changes what sends: only submitting it freezes the version a send serves. Sending by
template lives on `email send`, whose `--template` takes the handle or an `emt_` id.

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                                           |
| ------------------------------------------------------------ | ----------------------------------------------------- |
| [`create`](/docs/cli/reference/email-templates-create)       | Create an email template and its first editable draft |
| [`delete`](/docs/cli/reference/email-templates-delete)       | Delete an email template                              |
| [`duplicate`](/docs/cli/reference/email-templates-duplicate) | Duplicate an email template                           |
| [`get`](/docs/cli/reference/email-templates-get)             | Get an email template                                 |
| [`list`](/docs/cli/reference/email-templates-list)           | List email templates                                  |
| [`preview`](/docs/cli/reference/email-templates-preview)     | Render a template with sample values                  |
| [`update`](/docs/cli/reference/email-templates-update)       | Update an email template                              |
| [`versions`](/docs/cli/reference/email-templates-versions)   | Submit, read, and roll back template versions         |