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.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”The saved override’s template name. Surrounding whitespace is trimmed; it doesn’t have to be a currently registered template.
The saved override’s part. Surrounding whitespace is trimmed, and the pair is deleted without checking the current part catalogue.
Responses
Section titled “ Responses ”The matching source override was removed. No response body.
Malformed request
object
Human-readable error summary
Example
the request could not be completedAuthentication required, missing, or invalid
object
Human-readable error summary
Example
the request could not be completedExample
{ "error": "authentication required: sign in and retry with a valid session or API token"}Authenticated but missing required capabilities
object
Human-readable error summary
Example
the request could not be completedResource not found
object
Human-readable error summary
Example
the request could not be completed