# Delete one language from a draft

`DELETE /v1/email/templates/{template_ref}/versions/{version_id}/languages/{language}`

Removes one language from the template's draft, along with its content. Every other language is untouched, and the change takes effect for sends when you next submit.

The draft's current default language cannot be removed on its own. Point the default at a different language first, then remove the old one; doing it in the other order returns a `422` `validation_error`. Removing a language the draft does not have returns a `404` `not_found_error`, and only a draft can be changed, so addressing a published version also returns a `422` `validation_error`.

## Code samples

### CLI

```sh
bird email templates versions languages delete <template-ref> <version-id> <language> --yes
```

### cURL

```sh
curl -X DELETE "https://us1.platform.bird.com/v1/email/templates/{template_ref}/versions/{version_id}/languages/{language}" \
  -H "Authorization: Bearer $TOKEN"
```

## Path parameters

- `template_ref` (string): The template's id (`emt_…`) or slug. On read, a built-in `system` template's `bird_` slug also resolves here. Writing or removing a language requires a workspace template, because a `system` template has no draft to edit and returns `404` `not_found_error`.
- `version_id` (string)
- `language` (string)

## Related resources

- [How to build an email template](/learn/email/how-to-build-an-email-template) (video)
- [Email templates](/products/email/templates) (product)
- [Build your first integration](/learn/paths/integration) (course)
- [Email templates](/docs/guides/email/templates) (docs)

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