PUT /api/admin/blocks/:id — Изменить справочный блок
Сгенерировано из матриц + кода. Правки вносить в источники (
docs/matrices/,server/routes/), не здесь.
| Поле | Значение |
|---|---|
| HTTP | PUT /api/admin/blocks/:id |
| Auth | requireSiteAdmin — только site-admin |
| Scope токена | read_write |
| PG-функции | api.upsert_template_block |
| Таблицы | — |
| SRM | — (вне SRM, документировано по коду) |
| RP (права) | — |
| Файл роута | server/routes/admin.js |
| Статус | по коду (вне SRM) |
Аргументы запроса (best-effort из хендлера; путь-параметры опущены):
| Аргумент | Где | Обяз. | Заметка |
|---|---|---|---|
default_roles | body | подтвердить | |
description | body | подтвердить | |
layer | body | подтвердить | |
layer_code | body | подтвердить | |
name | body | подтвердить | |
sort_order | body | подтвердить |
Коды ответов/ошибок (из хендлера): 400, 500 (+ 200) — уточнить причины вручную
Для человека
Как открыть: войдите как site-admin (TOTP, см. Вход в Admin Panel) → Admin Panel → раздел справочника платформы → выберите справочный блок → измените поля и сохраните.
Меняет существующий эталонный блок справочника: имя, описание, роли по умолчанию, слой, порядок. Сам id блока — системный ключ, его этой операцией не трогают (он берётся из адреса). Под капотом тот же upsert, что и при создании.
Что важно знать. Блок справочный, поэтому правка отражается на всех коллекциях по умолчанию, которые от него отталкиваются. Если указать несуществующий код слоя — изменение отклонится с ошибкой 400.
Кто может. Только site-admin.
Для агента
Токену недоступно ни на каком scope. Site-admin-операция: requireSiteAdmin + блокировка /api/admin/* в агентном шлюзе (server/auth/agentGate.js). Bearer → 403. Только cookie-сессия site-admin.
Путь: :id — системный ключ блока (берётся из URL, в теле не передаётся).
Тело запроса (JSON):
| Поле | Тип | Обяз. | Назначение |
|---|---|---|---|
name | string | да | Отображаемое имя |
description | string | нет | Описание |
default_roles | string[] | нет | Роли по умолчанию; пусто → [] |
layer_code | string | нет | Код слоя (синоним layer); неизвестный → 400 |
sort_order | int | нет | Порядок сортировки |
Пример (cookie-сессия site-admin):
curl -X PUT https://specbuilder.vnimanie.ai/api/admin/blocks/feature-store \ -b cookies.txt \ -H "Content-Type: application/json" \ -d '{"name":"Feature Store v2","layer_code":"IMPLEMENTATION","sort_order":20}'Ответ 200:
{ "ok": true }Markdown-зеркала/affordances у ресурса нет.