PUT /api/admin/roles/:id — Изменить справочную роль
Как открыть: войдите как site-admin (TOTP, см. Вход в Admin Panel) → Admin Panel → раздел справочника платформы → выберите справочную роль → измените поля и сохраните.
Меняет существующую эталонную роль справочника: имя, цвета оформления, описание, порядок. id роли — системный ключ, его операцией не трогают (он берётся из адреса). Под капотом тот же upsert, что и при создании.
Что важно знать. Роль справочная, поэтому смена оформления или имени отразится везде, где роль используется как палитра для коллекций. Если ключ из адреса не существует — он просто заведётся как новая запись (логика upsert).
Кто может. Только site-admin.
Связанные
Машинная сводка (HTTP, таблицы, связанные требования)
| Поле | Значение |
|---|---|
| HTTP | PUT /api/admin/roles/:id |
| Auth | requireSiteAdmin — только site-admin |
| Scope токена | read_write |
| PG-функции | api.upsert_template_role |
| Таблицы | — |
| SRM | — (вне SRM, документировано по коду) |
| RP (права) | — |
| Файл роута | server/routes/admin.js |
| Статус | по коду (вне SRM) |
Аргументы запроса (best-effort из хендлера; путь-параметры опущены):
| Аргумент | Где | Обяз. | Заметка |
|---|---|---|---|
border | body | подтвердить | |
color | body | подтвердить | |
description | body | подтвердить | |
light | body | подтвердить | |
name | body | подтвердить | |
sort_order | body | подтвердить |
Коды ответов/ошибок (из хендлера): 400, 500 (+ 200) — уточнить причины вручную