# Template management | Developer Documentation

<div id="bkmrk-template-managementu">## Template management

<div><span>Updated: Nov 14, 2025</span></div><div>Learn about common endpoints used to manage templates.</div><div id="bkmrk-edit-templates"><div id="bkmrk-edit-templates-1"><div>### Edit templates

</div></div></div><div id="bkmrk-limitations"><div id="bkmrk-limitations-1"><div>#### Limitations

</div></div></div><span>Only templates with an `APPROVED`, `REJECTED`, or `PAUSED` status can be edited.</span><span>You can only edit a template's category, components, or time-to-live.</span><span>You cannot edit individual template components; all components will be replaced with the components in the edit request payload.</span><span>You cannot edit the category of an approved template.</span><span>Approved templates can be edited up to 10 times in a 30 day window, or 1 time in a 24 hour window. Rejected or paused templates can be edited an unlimited number of times.</span><span>After editing an approved or paused template, it will automatically be approved unless it fails template review.</span><div id="bkmrk-delete-templates"><div id="bkmrk-delete-templates-1"><div>### Delete templates

</div></div></div><div id="bkmrk-limitations-3"><div id="bkmrk-limitations-4"><div>#### Limitations

</div></div></div><span>If you delete a template that has been sent in a template message but has yet to be delivered (e.g. because the customer's phone is turned off), the template's status will be set to `PENDING_DELETION` and we will attempt to deliver the message for 30 days.</span><span>If you delete an approved template, you cannot create a new template with the same name for 30 days.</span><span>Templates that are in a disabled status cannot be deleted.</span><div id="bkmrk-delete-template-by-n"><div id="bkmrk-delete-template-by-n-1"><div>#### Delete template by name

</div></div></div><div>Deleting a template by name deletes all templates that match that name (meaning templates with the same name but different languages will also be deleted).</div><div id="bkmrk-delete-template-by-i"><div id="bkmrk-delete-template-by-i-1"><div>#### Delete template by ID

</div></div></div><div>To delete a template by ID, include the template's ID along with its name in your request; only the template with the matching template ID will be deleted.</div></div>