Skip to main content
DELETE
/
templates
/
{id}
Delete template
curl --request DELETE \
  --url https://api.nexrender.com/api/v2/templates/{id} \
  --header 'Authorization: Bearer <token>'
{
  "error": "<string>"
}
Nexrender Cloud allows you to delete templates that are no longer needed. This is useful for:
  • Removing test or temporary assets
  • Cleaning up deprecated campaign templates
  • Managing storage usage in your account

​
When Should You Delete a Template?

You might want to delete a template when:
  • It has been replaced by a newer version
  • It was used for testing and is no longer relevant
  • You’re cleaning up automation clutter in your account
Deleting a template does not affect existing jobs that already used it. Those jobs remain in the system and their output remains accessible.

​
What Happens After Deletion?

ComponentStatus
Template metadataPermanently deleted from Nexrender Cloud
Uploaded fileRemoved from storage (Cloudflare R2 or equivalent)
Associated jobsRemain intact — no data loss
RenderingNew jobs using this template will fail with 404
If you attempt to reference a deleted template in a job request, you’ll receive a 404 Template Not Found.

​
Edge Cases & Notes

  • You cannot delete a template while it’s actively rendering.
  • If a template is in awaiting_upload, you can delete it immediately.
  • Deletion is immediate and irreversible — no soft-delete or recovery options.
  • You can safely delete templates that had webhook or font dependencies — those are not linked permanently.

​
Suggested Practice

To keep things clean:
  • Delete unused templates after testing flows
  • Use versioned displayNames so you know what’s safe to remove
  • Add deletion as part of your CI teardown if you’re creating templates dynamically.

​
API Reference

Authorizations

​
Authorization
string
header
required

Bearer token authentication using API tokens for team-based access control.

You can generate your own API token at: https://app.nexrender.com/team/settings

Path Parameters

​
id
string
required

Unique template identifier to delete

Response

Template successfully deleted