POST /api/site-admin/organizations — Создать организацию
Как открыть: Admin Panel (пароль → код TOTP) → раздел «Организации» → кнопка «Создать» (или «Добавить»). Заполните название и короткий код, подтвердите.
Заводит новую организацию на платформе. Нужны два поля:
- Название — как организация будет называться (можно по-человечески, с пробелами).
- Код (slug) — короткий адресный идентификатор: только строчные латинские буквы, цифры и дефис. Иначе — ошибка
400с подсказкой про допустимые символы.
Код должен быть уникальным: если такой уже занят другой организацией, создание не пройдёт (409). Оба поля обязательны — без любого из них вернётся 400. Создателем записи отмечается тот администратор платформы, который её завёл. Сразу после создания организация попадает в общий список; дальше ей обычно назначают администратора.
Кто может. Только администратор платформы. Создание новых организаций — операция уровня платформы, у администратора организации её нет.
Связанные
- Экраны: Admin Panel
- Конвенции · Роли · Ошибки · Глоссарий
Машинная сводка (HTTP, таблицы, связанные требования)
| Поле | Значение |
|---|---|
| HTTP | POST /api/site-admin/organizations |
| Auth | requireSiteAdmin — только site-admin |
| Scope токена | read_write |
| PG-функции | api.admin_create_org |
| Таблицы | organization |
| SRM | SRM-072 |
| RP (права) | RP-060, RP-061, RP-062 |
| Файл роута | server/routes/site-admin.js |
| Статус | done |
Аргументы запроса (best-effort из хендлера; путь-параметры опущены):
| Аргумент | Где | Обяз. | Заметка |
|---|---|---|---|
name | body | подтвердить | |
slug | body | подтвердить |
Коды ответов/ошибок (из хендлера): 201, 400 (+ 200) — уточнить причины вручную