> ## 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.
# List email templates
> This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.
Returns the app's email templates, newest first, without their HTML. Get a template's HTML with [Get email template](/api-reference/get-email-template).
An app's email templates are files in its code, in `base44/emails/`. The AI creates and edits them through [Send chat message](/api-reference/send-chat-message).
You get up to `limit` templates, at most 200, and there's no pagination.
This is limited to 60 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. [Get email stats](/api-reference/get-email-stats) shares it.
This endpoint accepts a personal API key belonging to a user with access to the app. A read-only key is refused, and workspace API keys are not accepted.
The response includes fields beyond the ones documented here. Don't rely on undocumented response fields, as they can change at any time.
## OpenAPI
````yaml /developers/references/app-management/app-management-openapi.json get /api/apps/{app_id}/emails
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:
get:
summary: List email templates
description: >-
This API is in beta. Endpoints, fields, and behavior may still
change, so avoid depending on it in production.
Returns the app's email templates, newest first, without their HTML. Get
a template's HTML with [Get email
template](/api-reference/get-email-template).
An app's email templates are files in its code, in `base44/emails/`. The
AI creates and edits them through [Send chat
message](/api-reference/send-chat-message).
You get up to `limit` templates, at most 200, and there's no pagination.
This is limited to 60 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. [Get email
stats](/api-reference/get-email-stats) shares it.
This endpoint accepts a personal API key belonging to a user with
access to the app. A read-only key is refused, and workspace API keys
are not accepted.
The response includes fields beyond the ones documented here.
Don't rely on undocumented response fields, as they can change at any
time.
operationId: list_email_templates_api_apps__app_id__emails_get
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: limit
in: query
required: false
schema:
type: integer
maximum: 200
minimum: 1
description: >-
Maximum number of templates to return, from 1 to 200. Defaults to
30.
default: 30
title: Limit
description: >-
Maximum number of templates to return, from 1 to 200. Defaults to
30.
example: 50
responses:
'200':
description: The app's email templates, newest first.
content:
application/json:
schema:
$ref: '#/components/schemas/EmailTemplates'
'401':
description: Missing or invalid credentials.
'403':
description: >-
You don't have 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.
'422':
description: '`limit` is outside 1 to 200.'
'429':
description: >-
Rate limit exceeded. The base limit is 60 requests per minute. See
[Rate
limits](/developers/references/apps-api/get-started/rate-limits) for
the multiplier your plan gets.
components:
schemas:
EmailTemplates:
items:
$ref: '#/components/schemas/EmailTemplateSummary'
type: array
title: EmailTemplates
description: The app's email templates.
EmailTemplateSummary:
properties:
id:
type: string
title: Id
description: ID of the template.
example: 68c1f0a2b3d4e5f6a7b8c9d0
app_id:
type: string
title: App Id
description: ID of the app the template belongs to.
example: 6820f3a4e7b91d003c45a1f2
name:
type: string
title: Name
description: >-
Name of the template, from its file name: the template in
`base44/emails/Welcome.html` is `Welcome`. A workflow's send email
action or a backend function's `SendEmail` call picks the template
by this name.
example: Welcome
created_date:
type: string
format: date-time
title: Created Date
description: >-
When the template was created, as a UTC timestamp in ISO 8601
format.
example: '2026-09-14T08:30:12.418000Z'
updated_date:
type: string
format: date-time
title: Updated Date
description: >-
When the template last changed, as a UTC timestamp in ISO 8601
format.
example: '2026-09-14T08:30:12.418000Z'
type: object
required:
- id
- app_id
- name
- created_date
- updated_date
title: EmailTemplateSummary
description: An email template, without its HTML.
securitySchemes:
PersonalAccessTokenAuth:
type: http
scheme: bearer
description: 'Personal access token, sent as `Authorization: Bearer `.'
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.