---
title: "Delete email template"
method: DELETE
path: "/api/apps/{app_id}/emails/{template_id}"
---

# Delete email template

`DELETE /api/apps/{app_id}/emails/{template_id}`

## Request

- Base URL: `https://app.base44.com`
- URL: `https://app.base44.com/api/apps/{app_id}/emails/{template_id}`
- Auth: HTTP bearer

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Deletes an email template by removing its file from the app's code. This can't be undone.

Workflows and backend functions that send the template by name keep it in their code, and those sends fail once it's gone. Deleting the app's own version of an application email, such as `PasswordReset`, makes the app send the Base44 version again.

If the file can't be removed, the template isn't deleted, and you can retry.

This is limited to 20 requests per minute per app for each workspace's personal API keys, so every key in a workspace shares one allowance. Some workspaces have a different limit.

<Note>This endpoint accepts a personal API key belonging to a user with editor access to the app. A read-only key is refused, and workspace API keys are not accepted.</Note>

## Path parameters

- `app_id` string, required: ID of the app the emails belong to.
- `template_id` string, required: ID of the email template to delete. Get it from `id` in [List email templates](/api-reference/list-email-templates).

## Response `200`

The template was deleted.

- DeletedEmailTemplate
  - `deleted` string, required: Name of the deleted template.

## Other responses

- `401`: Missing or invalid credentials.
- `403`: You don't have editor access to this app, the app is blocked, your API key is read-only, or you used a workspace API key.
- `404`: App not found, or the app has no email template with this ID.
- `429`: Rate limit exceeded. The base limit is 20 requests per minute. See [Rate limits](/developers/references/apps-api/get-started/rate-limits) for the multiplier your plan gets.

## Changes

- **2026-10-11** `80287813ab84`: 1 info
  - the endpoint scheme security `PersonalAccessTokenAuth` was added to the API
- **2026-10-10** `fc604cdcc3a2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/idealspot/apis/base44-app-management-api/changes/api/apps/:app_id/emails/:template_id/delete.md)

---

[API](https://skmtc.dev/idealspot/apis/base44-app-management-api.md) - [All operations](https://skmtc.dev/idealspot/apis/base44-app-management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/idealspot/apis/base44-app-management-api/revisions/b5b4ebd82a1e?raw)