> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Internal links on these pages omit the .md extension. Append .md to a docs page URL, or send an Accept: text/markdown header, to get that page as markdown.

# Delete email template

> <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>



## OpenAPI

````yaml /developers/references/app-management/app-management-openapi.json delete /api/apps/{app_id}/emails/{template_id}
openapi: 3.1.0
info:
  title: Base44 App Management API
  version: 1.0.0
servers:
  - url: https://app.base44.com
security:
  - PersonalAccessTokenAuth: []
paths:
  /api/apps/{app_id}/emails/{template_id}:
    delete:
      summary: Delete email template
      description: >-
        <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>
      operationId: delete_email_template_api_apps__app_id__emails__template_id__delete
      parameters:
        - name: app_id
          in: path
          required: true
          schema:
            type: string
            description: ID of the app the emails belong to.
            title: App Id
          description: ID of the app the emails belong to.
          example: 6820f3a4e7b91d003c45a1f2
        - name: template_id
          in: path
          required: true
          schema:
            type: string
            description: >-
              ID of the email template to delete. Get it from `id` in [List
              email templates](/api-reference/list-email-templates).
            title: Template Id
          description: >-
            ID of the email template to delete. Get it from `id` in [List email
            templates](/api-reference/list-email-templates).
          example: 68c1f0a2b3d4e5f6a7b8c9d0
      responses:
        '200':
          description: The template was deleted.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeletedEmailTemplate'
        '401':
          description: Missing or invalid credentials.
        '403':
          description: >-
            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':
          description: App not found, or the app has no email template with this ID.
        '429':
          description: >-
            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.
components:
  schemas:
    DeletedEmailTemplate:
      properties:
        deleted:
          type: string
          title: Deleted
          description: Name of the deleted template.
          example: Welcome
      type: object
      required:
        - deleted
      title: DeletedEmailTemplate
  securitySchemes:
    PersonalAccessTokenAuth:
      type: http
      scheme: bearer
      description: 'Personal access token, sent as `Authorization: Bearer <token>`.'

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.