Delete an email template
DELETE
/v1/email/templates/{template_ref}
bird email templates delete <template-ref> --yescurl -X DELETE "https://us1.platform.bird.com/v1/email/templates/{template_ref}" \
-H "Authorization: Bearer $TOKEN"Deletes the template and all its versions. The slug becomes available for reuse in the workspace, and the deletion cannot be undone.
A template can't be deleted while a broadcast that has not started sending still uses it, because a scheduled or accepted broadcast has not pinned the content it will send yet. List the broadcasts blocking a template delete to see which ones those are. A broadcast that has already started sending does not block the delete: it pinned its version when it started, so it keeps sending the content it froze.
Parameters
template_ref
string
The template's id (emt_…) or slug. On read, a built-in system template's bird_ slug also resolves here. Write operations (update, delete) accept a workspace template only, because a system template is immutable.
Related resources
Continue with the documentation, guides and examples for this topic. Resources are in English.
Watch the guideHow to build an email templateExplore the capabilityEmail templatesFollow the learning pathBuild your first integrationImplementation guideEmail templates
Try the practice and get an implementation brief