GET /api/collections/deleted — Удалённые коллекции

Сгенерировано из матриц + кода. Правки вносить в источники (docs/matrices/, server/routes/), не здесь.

Поле	Значение
HTTP	`GET /api/collections/deleted`
Auth	`requireAuth` — только авторизованный
Scope токена	`read`
PG-функции	—
Таблицы	—
SRM	— (вне SRM, документировано по коду)
RP (права)	—
Файл роута	`server/routes/collections.js`
Статус	по коду (вне SRM)

Аргументы запроса (best-effort из хендлера; путь-параметры опущены):

аргументов не обнаружено (подтвердить вручную по server/routes/collections.js)

Коды ответов/ошибок (из хендлера): 401, 403, 500 (+ 200) — уточнить причины вручную

Для человека

Как открыть: в навигации «Коллекции» → откройте «Корзину» удалённых коллекций.

Показывает коллекции, которые удалили мягко — то, что лежит в корзине. По каждой видно название, описание и дату удаления. Отсюда коллекцию можно восстановить.

Кто видит. Корзина доступна администратору организации; администратор платформы видит удалённые коллекции всех организаций.

Для агента

Чтение — достаточно токена со scope read (см. Конвенции). Роут под requireAuth; доступ к разделу проверяется внутри — нужны права администратора (org-admin), иначе 403; без токена — 401.

Тела у запроса нет. Возвращаются записи с непустым deleted_at, отсортированные по дате удаления (свежие сверху).

Пример запроса:

curl https://specbuilder.vnimanie.ai/api/collections/deleted \
  -H "Authorization: Bearer tak_..." \
  -H "Accept: text/markdown"

Ответ 200:

[
  { "id": "0660b640-86b0-42c5-8e22-93973848bb56", "code": "agro-ml",
    "name": "Точное земледелие", "description": "Шаблон для агро-проектов",
    "deleted_at": "2026-06-20T11:42:00Z" }
]

Cookie-клиент всегда получает JSON; Markdown-зеркало отдаётся только токену с Accept: text/markdown (server/agent/negotiate.js). Восстановление — POST /api/collections/{id}/restore.

Связанные

Конвенции · Роли · Ошибки · Глоссарий