DELETE /api/spaces/:spaceId/layers/:id — Удалить слой спейса
Сгенерировано из матриц + кода. Правки вносить в источники (
docs/matrices/,server/routes/), не здесь.
| Поле | Значение |
|---|---|
| HTTP | DELETE /api/spaces/:spaceId/layers/:id |
| Auth | requireSpacemanOrOrgAdmin — requireSpacemanOrOrgAdmin |
| Scope токена | read_write |
| PG-функции | api.delete_space_layer |
| Таблицы | space_layer_overlay |
| SRM | SRM-168 |
| RP (права) | RP-053 |
| Файл роута | server/routes/spaces.js |
| Статус | done |
Аргументы запроса (best-effort из хендлера; путь-параметры опущены):
аргументов не обнаружено (подтвердить вручную по server/routes/spaces.js)
Коды ответов/ошибок (из хендлера): 200 — уточнить причины вручную
Для человека
Как открыть: верхняя панель → «Спейсы» → карточка спейса → вкладка «Слои» → удалите слой из строки списка.
Убирает слой из спейса. Поведение зависит от происхождения слоя:
- базовый слой коллекции — не стирается насовсем, а скрывается в этом спейсе (в оверлее помечается удалённым). В коллекции и других спейсах он остаётся, а здесь его всегда можно вернуть;
- кастомный слой — он жил только в этом спейсе, поэтому удаляется без следа.
Помните, что слой — это этап документа; убирая слой, вы убираете и его дорожку в графе. Для унаследованного слоя удаление обратимо — это скрытие.
Кто может. Менеджер своего спейса или администратор организации (RP-128). Сотрудник и наблюдатель слои не удаляют.
Для агента
Запись — токен со scope read_write; доступ проверяет requireSpacemanOrOrgAdmin (спейсмен спейса или org-admin его организации), иначе 403. Путь занесён в write-allowlist agent-gate точным шаблоном (server/auth/agentGate.js).
Путь-параметры — :spaceId и :layerId. Тела у запроса нет. Для унаследованного слоя это скрытие (обратимо через восстановление); для кастомного — удаление строки оверлея.
Пример запроса:
curl -X DELETE https://specbuilder.vnimanie.ai/api/spaces/{spaceId}/layers/{layerId} \ -H "Authorization: Bearer tak_..."Ответ 200: { "ok": true }. Только JSON, без ETag. Скрытый слой уходит из списка слоёв.