How to Delete an Instance Template

Deleting an instance template permanently removes it from your account. Instances that you already created from the template continue to run and remain unaffected.

This guide explains how to delete an instance template using the Vultr API.

1. (Optional) To keep a cluster-created template instead of deleting it, send a POST request to the Promote Instance Template endpoint. Replace {template-id} with the template's ID.

   CONSOLE

   Copy

   $ curl "https://api.vultr.com/v2/instances/templates/{template-id}/promote" \
       -X POST \
       -H "Authorization: Bearer ${VULTR_API_KEY}"

   Explain Code

   Powered by Vultr AgentBeta

   A successful request returns an HTTP 200 OK response with the template's ephemeral field now false. Promoting is one-way. A permanent template cannot be made ephemeral again.

2. Send a GET request to the List Instance Templates endpoint to retrieve all templates.

   CONSOLE

   Copy

   $ curl "https://api.vultr.com/v2/instances/templates" \
       -X GET \
       -H "Authorization: Bearer ${VULTR_API_KEY}"

   Explain Code

   Powered by Vultr AgentBeta

   Note the id of the template you want to delete.

3. Send a DELETE request to the Delete Instance Template endpoint to delete the template. Replace {template-id} with the template's ID.

   CONSOLE

   Copy

   $ curl "https://api.vultr.com/v2/instances/templates/{template-id}" \
       -X DELETE \
       -H "Authorization: Bearer ${VULTR_API_KEY}"

   Explain Code

   Powered by Vultr AgentBeta

   A successful deletion returns an HTTP 204 No Content response with no response body.

4. Send a GET request to the List Instance Templates endpoint to retrieve all templates.

   CONSOLE

   Copy

   $ curl "https://api.vultr.com/v2/instances/templates" \
       -X GET \
       -H "Authorization: Bearer ${VULTR_API_KEY}"

   Explain Code

   Powered by Vultr AgentBeta

   Verify that the deleted template no longer appears in the list.