# Update email template API

> Update email template API reference: PATCH /templates/:id changes a template draft. Live email keeps using the published version until you publish again.

Canonical: https://www.cresca.xyz/docs/api-reference/update-template
Last updated: 2026-11-05

Use the update email template API to change a template draft. Live email keeps using the published version until you publish again.

PATCH https://api.cresca.xyz/api/v1/templates/:id

Requires a full-access key. Send only the fields you want to change; they take the same values as in [Create template](https://www.cresca.xyz/docs/api-reference/create-template). Send `null` for `alias` to remove it. Sending `html` replaces the template's visual-editor design, so from then on the template is edited as HTML.

Updates change the draft only. Emails keep using the published version until you [publish](https://www.cresca.xyz/docs/api-reference/publish-template) again.

### Path parameters

id string required

The template id or alias.

## Update email template API example

Request

```bash
curl -X PATCH 'https://api.cresca.xyz/api/v1/templates/password-reset' \
  -H 'Authorization: Bearer cr_live_xxxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
  "subject": "Reset your Acme password"
}'
```

Response 200

```json
{
  "object": "template",
  "id": "6713b1f4c2a94e0012ab34cd"
}
```

[Previous List templates](https://www.cresca.xyz/docs/api-reference/list-templates) [Next Publish template](https://www.cresca.xyz/docs/api-reference/publish-template)

Last updated November 5, 2026. Questions? [lalit@cresca.xyz](mailto:lalit@cresca.xyz)
