Skip to content

Revert an email-template override

DELETE
/email-templates/{template}/{part}

Removes the saved override for one email-template part.

You need system.config.write or system.admin for the whole install; a permission held only for a team doesn’t count. Without one you get 403, and signed-out callers get 401. The handler trims the template name and part, then deletes that exact pair. It doesn’t check the pair against the current registry, so a stored override for a removed template or part can still be deleted.

A removed row gets 204 with no body. No matching row gets 404, including a repeat removal when nothing has recreated the override. Other parts and templates are left alone.

The server clears this app instance’s rendering-cache entry and tries to notify other instances. Once a render sees the override is gone, it uses the shipped source for that part. A successful delete doesn’t guarantee the next send has refreshed its cache; another instance or a render already in progress can still use older data. It doesn’t send mail or recall messages already rendered or delivered.

A concurrent save can recreate the override. There’s no version check, and no single call reverts every part together.

template
required
string

The saved override’s template name. Surrounding whitespace is trimmed; it doesn’t have to be a currently registered template.

part
required
string

The saved override’s part. Surrounding whitespace is trimmed, and the pair is deleted without checking the current part catalogue.

The matching source override was removed. No response body.

Malformed request

object
error
required

Human-readable error summary

string
Example
the request could not be completed

Authentication required, missing, or invalid

object
error
required

Human-readable error summary

string
Example
the request could not be completed
Example
{
"error": "authentication required: sign in and retry with a valid session or API token"
}

Authenticated but missing required capabilities

object
error
required

Human-readable error summary

string
Example
the request could not be completed

Resource not found

object
error
required

Human-readable error summary

string
Example
the request could not be completed