Skip to main content
PATCH
Update an email template

Authorizations

Api-Token
string
header
required

Server-to-server authentication. Generate a token in the admin UI at Settings → Developers → API Access. Send the raw token in the Api-Token header — there is no Bearer prefix.

Tokens can be marked read-only at creation time, in which case the API rejects any non-GET request with 403 Forbidden.

Path Parameters

id
string
required

EmailTemplate identifier

Body

application/merge-patch+json

The updated EmailTemplate resource

A tenant's own version of one email type.

Every email is rendered from its Twig (templates/emails/{type}.html.twig, on layouts/card.html.twig), the only design. A tenant changes wording only: $texts holds it per language and text id, edited in place in the admin (EmailTemplateInlineEditor) and filled in by |email_text. $html is the old whole-document format: sent as is until the tenant saves again, and dropped by app:email-templates:reset-legacy once the notice period ends.

Which types a tenant may edit is the list in the admin's Email Templates screen: emails the organisation sends its members and contacts, without one-time codes. SYSTEM_TYPES below can never be stored, whatever the client sends: they carry codes or password changes.

type
string
subject
string | null
html
string | null

Response

EmailTemplate resource updated

A tenant's own version of one email type.

Every email is rendered from its Twig (templates/emails/{type}.html.twig, on layouts/card.html.twig), the only design. A tenant changes wording only: $texts holds it per language and text id, edited in place in the admin (EmailTemplateInlineEditor) and filled in by |email_text. $html is the old whole-document format: sent as is until the tenant saves again, and dropped by app:email-templates:reset-legacy once the notice period ends.

Which types a tenant may edit is the list in the admin's Email Templates screen: emails the organisation sends its members and contacts, without one-time codes. SYSTEM_TYPES below can never be stored, whatever the client sends: they carry codes or password changes.

id
integer
read-only
type
string
subject
string | null
html
string | null
texts
(string | null)[] | null