---
title: "DELETE /templates/{template} — Delete Template"
url: https://lumean.app/developers/docs/api/delete-templates-template
locale: ru
description: "Delete Template"
generated: 2026-10-17
operationId: template.destroy
method: DELETE
path: "/templates/{template}"
scopes: [templates.write]
spec_version: 0.0.1
---

# DELETE /templates/{template}

**Delete Template**

Удаляет шаблон владельца ключа. **Необратимо**, подтверждения не спрашивает: шаблон
пропадает из `GET /templates` и `GET /templates/browse`, запросы к
`/templates/{template}` отвечают `404`, а новый заказ или превью чанков с этим
`template_id` — `422`, как на несуществующий шаблон.

Ранее созданные по шаблону заказы и их результаты остаются на месте и выполняются с
настройками на момент своего создания (заказы, созданные до конца сентября 2026 года,
снимка не имеют — они выполняются по конфигу шаблона на момент удаления). Если заказы
по шаблону есть, он сохраняется скрытым: `GET /orders/{order}` по-прежнему показывает
его в поле `template` — с `config` этого заказа.

**Требуемое право ключа:** `templates.write`.

- Право ключа: `templates.write`

## Запрос

```bash
curl -X DELETE 'https://api.lumean.app/api/public/templates/{template}' \
  -H 'Accept: application/json' \
  -H 'X-API-KEY: YOUR_API_KEY'
```

## Параметры

| Поле | Где | Тип | Обяз. | Описание |
| --- | --- | --- | --- | --- |
| `template` | path | `string` — uuid | обяз. | UUID шаблона — 36 символов, не число. Берётся из поля `id`: его возвращает `POST /templates` при создании, а также `GET /templates` и `GET /templates/browse` в списках. default: `4d3e9f8b-2c1a-4f5a-8b9c-0d1e2f3a4b5c` |

## Тело запроса

Тела нет.

## Ответы

### 200 — Шаблон удалён

**Поля ответа**

| Поле | Тип | Обяз. | Описание |
| --- | --- | --- | --- |
| `success` | `boolean` | обяз. | Признак успеха. Решение принимайте по HTTP-коду: у любого ответа 2xx здесь `true`, а ошибка приходит телом другой формы, где этого поля может не быть вовсе. |
| `message` | `string` | обяз. | Пояснение для человека, на языке аккаунта. Показать пользователю можно; разбирать программно — нет: формулировки меняются без предупреждения и кодом ошибки не являются. |
| `data` | `null` — nullable | обяз. | Всегда `null`: удалять больше нечего. Факт удаления подтверждает код `200`. |

**Пример**

```json
{
  "success": true,
  "message": "Template deleted",
  "data": null
}
```

### 401 — Невалидный или отсутствующий X-API-KEY

**Поля ответа**

| Поле | Тип | Обяз. | Описание |
| --- | --- | --- | --- |
| `success` | `boolean` | обяз. | Всегда `false` в ответах об ошибке. |
| `message` | `string` | обяз. | Текст ошибки на языке ключа (задаётся заголовком `X-Locale`). |
| `data` | `null` — nullable | обяз. | Всегда `null`, когда запрос отклонён до обработки. |

**Пример**

```json
{
  "success": false,
  "message": "API key is missing. Provide it in the X-API-KEY header.",
  "data": null
}
```

### 403 — Нет доступа к шаблону

**Поля ответа**

| Поле | Тип | Обяз. | Описание |
| --- | --- | --- | --- |
| `message` | `string` | обяз. | Error overview. |

**Пример**

```json
{
  "success": false,
  "message": "This API key does not have permission to perform this action."
}
```

### 404 — Шаблон не найден

**Поля ответа**

| Поле | Тип | Обяз. | Описание |
| --- | --- | --- | --- |
| `success` | `boolean` | обяз. | Всегда `false` в ответах об ошибке. |
| `message` | `string` | обяз. | Текст ошибки на языке ключа (задаётся заголовком `X-Locale`). |
| `reason` | `string` | — | Машиночитаемая причина — приходит у бизнес-отказов (например, `invalid_order_status`); у прочих ошибок поля нет. Ветвите обработку по нему, а не по тексту сообщения. |
| `error_code` | `string` | — | Тот же машинный код, что в `reason`, — второе имя поля. Приходит вместе с `reason`, значения всегда совпадают. |

**Пример**

```json
{
  "success": false,
  "message": "Resource not found."
}
```

---

- Эта же страница в браузере: https://lumean.app/developers/docs/api/delete-templates-template
- Машинный справочник целиком: https://api.lumean.app/docs/llm.md