---
title: "Soft-delete a template"
method: DELETE
path: "/v1/templates/{ref}"
tags: ["Templates"]
---

# Soft-delete a template

`DELETE /v1/templates/{ref}`

## Request

- Base URL: `https://api.galleyrender.com`
- URL: `https://api.galleyrender.com/v1/templates/{ref}`
- Auth: HTTP bearer

Existing renders keep working and their stored files are untouched, and renders pinned to `name@version` keep resolving. The name is released: creating a template with the same name afterwards succeeds and starts a new template at version 1.

## Path parameters

- `ref` string, required

## Response `200`

Deleted.

- object
  - `object` 'template', required
  - `id` string, required
  - `name` string, required
  - `deleted` true, required

## Other responses

- `401`: `authentication_error`.
- `404`: `not_found`.

---

[API](https://skmtc.dev/galleyrender/apis/galley-render-api.md) · [All operations](https://skmtc.dev/galleyrender/apis/galley-render-api/llms.txt) · [OpenAPI document](https://skmtc.dev/galleyrender/apis/galley-render-api/revisions/a85d68468cd2?raw)