POST /api/spaces/:id/layers/:layerId/clear-override — Снять переопределение слоя
Сгенерировано из матриц + кода. Правки вносить в источники (
docs/matrices/,server/routes/), не здесь.
| Поле | Значение |
|---|---|
| HTTP | POST /api/spaces/:id/layers/:layerId/clear-override |
| Auth | requireSpacemanOrOrgAdmin — requireSpacemanOrOrgAdmin |
| Scope токена | read_write |
| PG-функции | api.clear_space_layer_override |
| Таблицы | space_layer_overlay |
| SRM | SRM-253 |
| RP (права) | — |
| Файл роута | server/routes/spaces.js |
| Статус | done |
Аргументы запроса (best-effort из хендлера; путь-параметры опущены):
| Аргумент | Где | Обяз. | Заметка |
|---|---|---|---|
field | body | подтвердить | |
field | query | подтвердить |
Коды ответов/ошибок (из хендлера): 400 (+ 200) — уточнить причины вручную
Для человека
Как открыть: верхняя панель → «Спейсы» → карточка спейса → вкладка «Слои» → у поля, помеченного «изменено», нажмите «Вернуть исходное значение».
Снимает переопределение одного поля слоя: значение этого атрибута возвращается к коллекции, и пометка «изменено» исчезает. Остальные переопределения слоя остаются — откатывается ровно указанное поле (например, только doc_title, а цвет и имя — как были).
Два «возврата» легко перепутать:
- снять переопределение (этот метод) — поле возвращается к базовому значению из коллекции; слой всё это время оставался в спейсе;
- вернуть — возвращает слой, ранее удалённый (скрытый) в спейсе.
Чтобы откатить весь спейс — отдельное действие «Вернуть всё к исходному».
Кто может. Менеджер своего спейса или администратор организации (RP-129). Сотрудник и наблюдатель оверлей не трогают.
Для агента
Запись — токен со scope read_write; доступ проверяет requireSpacemanOrOrgAdmin (спейсмен спейса или org-admin его организации), иначе 403. Путь занесён в write-allowlist agent-gate точным шаблоном (server/auth/agentGate.js).
Путь-параметры — :id и :layerId. Нужно имя поля: передаётся как ?field=<имя> в query или как field в JSON-теле. Без него — 400 { "error": "field required" }. Имя поля — атрибут слоя (display_name, color, doc_title, sort_order, …).
Пример запроса:
curl -X POST "https://specbuilder.vnimanie.ai/api/spaces/{id}/layers/{layerId}/clear-override?field=doc_title" \ -H "Authorization: Bearer tak_..."Ответ 200: { "ok": true }. Только JSON, без ETag. Это возврат поля к значению коллекции — не путать с восстановлением удалённого слоя.