What it does
Deletes a single template. The template is first read from Meta to resolve its name, then deleted on Meta byname + template ID — so only the language version identified by source_id is removed, not every language sharing that name.
Endpoint
Headers
string
required
Secret key in
Bearer sk_... format. See Secret Key authentication.Path parameters
string
required
Application ID. Must belong to the organization (otherwise
404).string
required
The template’s Meta ID — the
sourceId returned by Get Templates or Create Template.Response
Success returns HTTP200 with an envelope that carries no payload: { "isSuccess": true }.
boolean
true when the template was deleted on Meta and soft-deleted locally.null
This endpoint has no payload.
data is null and, like every null field, is dropped from the response.Deleting one language version does not delete the other versions of the same template name — call the endpoint once per
sourceId.Examples
Demo 1 — delete a template
Demo 1 — delete a template
Demo 2 — delete one language version only
Demo 2 — delete one language version only
order_confirmation exists in both en and tr. Each language version has its own sourceId, so deleting the English one leaves the Turkish one untouched.Demo 3 — verify the deletion
Demo 3 — verify the deletion
After deleting, list the templates again; the record is gone.
Demo 4 — error: unknown template → 404
Demo 4 — error: unknown template → 404
Demo 5 — error: foreign app_id → 404
Demo 5 — error: foreign app_id → 404
Errors
object
Error details with
code, group, and description; isSuccess is false.Auth / tenant
Meta-side (template lookup + delete)
The lookup and the delete share the same error mapping, so a failure in either step surfaces the same codes.
Example error response (404 unknown template):