DELETE /api/admin/blocks/:id — Удалить справочный блок
Сгенерировано из матриц + кода. Правки вносить в источники (
docs/matrices/,server/routes/), не здесь.
| Поле | Значение |
|---|---|
| HTTP | DELETE /api/admin/blocks/:id |
| Auth | requireSiteAdmin — только site-admin |
| Scope токена | read_write |
| PG-функции | api.delete_template_block |
| Таблицы | — |
| SRM | — (вне SRM, документировано по коду) |
| RP (права) | — |
| Файл роута | server/routes/admin.js |
| Статус | по коду (вне SRM) |
Аргументы запроса (best-effort из хендлера; путь-параметры опущены):
аргументов не обнаружено (подтвердить вручную по server/routes/admin.js)
Коды ответов/ошибок (из хендлера): 400, 500 (+ 200) — уточнить причины вручную
Для человека
Как открыть: войдите как site-admin (TOTP, см. Вход в Admin Panel) → Admin Panel → раздел справочника платформы → выберите справочный блок → удалите.
Убирает эталонный блок из глобального справочника. Удаление каскадно снимает и справочные связи, которые шли в этот блок или из него.
Что важно знать. Удаление не ломает уже созданные проекты: ссылки из узлов проекта на удалённый блок просто обнуляются, графы остаются на месте. Но из палитры для будущих коллекций блок исчезнет. Действие необратимо — чтобы вернуть блок, его придётся завести заново.
Кто может. Только site-admin.
Для агента
Токену недоступно ни на каком scope. Site-admin-операция: requireSiteAdmin + блокировка /api/admin/* в агентном шлюзе (server/auth/agentGate.js). Bearer → 403. Только cookie-сессия site-admin.
Путь: :id — системный ключ блока. Тело не требуется.
Пример (cookie-сессия site-admin):
curl -X DELETE https://specbuilder.vnimanie.ai/api/admin/blocks/feature-store \ -b cookies.txtОтвет 200:
{ "ok": true }Каскад: связанные справочные рёбра удаляются вместе с блоком; ссылки из узлов проектов обнуляются (проекты не ломаются). Markdown-зеркала/affordances у ресурса нет.