POST /api/spaces/:id/blocks/:blockId — Переопределить блок
Как открыть: верхняя панель → «Спейсы» → карточка спейса → вкладка «Блоки». Дальше либо правьте поле у существующего блока (рядом появится пометка «изменено»), либо нажмите «Добавить» — так создаётся свой, кастомный блок.
Это операция переопределения блока поверх коллекции. Спейс не меняет саму коллекцию: вместо этого в спейсе заводится оверлей — слой кастомизации. Здесь у него две роли:
- переопределить базовый блок — задать в этом спейсе своё имя, описание, слой, специальности по умолчанию, порядок или страницу-пример, не трогая коллекцию. Поле, которое вы переопределили, помечается как «изменено», и его всегда можно вернуть к исходному значению (снять переопределение);
- добавить свой блок — если блока с таким id в коллекции нет, создаётся кастомный (
is_custom), живущий только в этом спейсе.
Не путайте с двумя похожими действиями: «вернуть исходное» снимает ваше переопределение и возвращает значение из коллекции, а «вернуть» возвращает ранее скрытый (удалённый в спейсе) блок.
Кто может. Менеджер своего спейса (спейсмен) или администратор организации (RP-128 для переопределения, RP-134 для своего блока). Сотрудник и наблюдатель оверлей не настраивают.
Связанные
Машинная сводка (HTTP, таблицы, связанные требования)
| Поле | Значение |
|---|---|
| HTTP | POST /api/spaces/:id/blocks/:blockId |
| Auth | — |
| Scope токена | read_write |
| PG-функции | — |
| Таблицы | — |
| SRM | — (вне SRM, документировано по коду) |
| RP (права) | — |
| Файл роута | server/routes/spaces.js |
| Статус | по коду (вне SRM) |
Аргументы запроса (best-effort из хендлера; путь-параметры опущены):
аргументов не обнаружено (подтвердить вручную по server/routes/spaces.js)
Коды ответов/ошибок (из хендлера): 200 — уточнить причины вручную