Email API
PUT/api/v1/email/templates/{name}
Product availabilityAlgaPSA

Update email template

Writes the tenant override for one template and language. The first write clones the system default, then applies the fields provided, so unspecified fields keep the standard content. System templates themselves are never modified.

RBAC · settings

Path parameters

namestringRequired
Kebab-case template name, such as ticket-created or invoice-email.

Request body

Content type: application/json · schema EmailTemplateUpdateRequest

language_codestringRequired
Language of the template being edited.
Enum: enen-AUfresdenlitplptxxyy
subjectstring
New subject line. Supports {{variable}} placeholders.
min length 1 · max length 998
html_contentstring
New HTML body. Supports {{variable}} placeholders.
min length 1
text_contentstring
New plain-text body.
min length 1

Response body

Success response 200 · schema EmailTemplateEnvelope

dataobjectRequired
One email template, system default and tenant override merged.
namestringRequired
Template name, shared by the system default and the tenant override.
language_codestringRequired
Language code of this row.
categorystringRequiredNullable
Notification category the template belongs to.
subjectstringRequired
Subject line that would be sent today.
is_customizedbooleanRequired
Whether the tenant has an override for this name and language.
system_template_idintegerRequiredNullable
tenant_template_idintegerRequiredNullable
updated_atstringRequiredNullable
When the tenant override was last written.
systemobjectRequiredNullable
The read-only system default.
idintegerRequired
subjectstringRequired
html_contentstringRequired
text_contentstringRequired
tenantobjectRequiredNullable
The tenant override, when one exists.
idintegerRequired
subjectstringRequired
html_contentstringRequired
text_contentstringRequired
effectiveobjectRequired
What actually ships: the override when present, otherwise the system default.
subjectstringRequired
html_contentstringRequired
text_contentstringRequired
metaobject

Response codes

200
Email template updated successfully.
400
Validation error.
401
Authentication failed.
403
Authenticated user lacks the settings update permission.
404
No template with that name and language.