Skip to main content
DELETE https://api.craftkit.dev/v1/templates/{slug}
Soft-delete the template at slug. The row is retained (marked deleted) but its slug is freed, so the same canonical slug can be recreated by POST /v1/templates or PUT /v1/templates/:slug. This is the cleanup path for idempotent provisioning and for retiring a template you no longer render.
Existing renders are untouched. They pin their own templateVersionId and remain fetchable by render id (and via any share links). Deleting a template removes it from list and get, and blocks new renders against that slug.
If you only need the newest layout, prefer PUT — it republishes in place and keeps the template id, slug, and render history. Reach for DELETE when you genuinely want the template gone.

​
Authorization

​
string
required
Bearer ck_live_… — must own the project.

​
Path

​
string
required
The slug of the template to delete.

​
Response

200:
​
string
The deleted template’s id.
​
string
The original (now-freed) slug, echoed back.
​
string
ISO-8601 timestamp of the soft-delete.
A second DELETE of the same slug returns 404 — the operation is idempotent in effect.

​
Errors

cURL
200