К содержанию
Lumean API

DELETE/templates/{template}

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

templates.write

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

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

На этой странице(3)

Параметры

Поля ввода живут прямо в строке запроса: подставьте значение — и получите готовый URL. Ниже — тип, обязательность и допустимые значения каждого параметра.

DELETEhttps://api.lumean.app/api/public/templates/
  • stringв путиобязательныйuuid

    UUID шаблона — 36 символов, не число.

    Берётся из поля id: его возвращает POST /templates при создании, а также GET /templates и GET /templates/browse в списках.

    Значение подставляется прямо в строку запроса выше.

Возможные ответы

200

Шаблон удалён

Пример тела
{
  "success": true,
  "message": "Template deleted",
  "data": null
}
Поля ответа
successобязательное

Признак успеха. Решение принимайте по HTTP-коду: у любого ответа 2xx здесь true, а ошибка приходит телом другой формы, где этого поля может не быть вовсе.

boolean
messageобязательное

Пояснение для человека, на языке аккаунта. Показать пользователю можно; разбирать программно — нет: формулировки меняются без предупреждения и кодом ошибки не являются.

string
dataобязательное

Всегда null: удалять больше нечего. Факт удаления подтверждает код 200.

может быть null
null
401

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

Разобрать этот ответ
Пример тела
{
  "success": false,
  "message": "API key is missing. Provide it in the X-API-KEY header.",
  "data": null
}
Поля ответа
successобязательное

Всегда false в ответах об ошибке.

boolean
messageобязательное

Текст ошибки на языке ключа (задаётся заголовком X-Locale).

string
dataобязательное

Всегда null, когда запрос отклонён до обработки.

может быть null
null
403

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

Разобрать этот ответ
Пример тела
{
  "success": false,
  "message": "This API key does not have permission to perform this action."
}
Поля ответа
messageобязательное

Error overview.

string
404

Шаблон не найден

Разобрать этот ответ
Пример тела
{
  "success": false,
  "message": "Resource not found."
}
Поля ответа
successобязательное

Всегда false в ответах об ошибке.

boolean
messageобязательное

Текст ошибки на языке ключа (задаётся заголовком X-Locale).

string
reasonнеобязательное

Машиночитаемая причина — приходит у бизнес-отказов (например, invalid_order_status); у прочих ошибок поля нет. Ветвите обработку по нему, а не по тексту сообщения.

string
error_codeнеобязательное

Тот же машинный код, что в reason, — второе имя поля. Приходит вместе с reason, значения всегда совпадают.

string

Рядом

Соседние операции

Скормить страницу ИИ

Открыть .mdllm.md

спека 0.0.1