GET /api/site-admin/organizations — Все организации

Сгенерировано из матриц + кода. Правки вносить в источники (docs/matrices/, server/routes/), не здесь.

Поле	Значение
HTTP	`GET /api/site-admin/organizations`
Auth	`requireSiteAdmin` — только site-admin
Scope токена	`read`
PG-функции	`api.list_all_orgs`
Таблицы	`organization`, `org_member`
SRM	SRM-071
RP (права)	RP-060, RP-061, RP-062
Файл роута	`server/routes/site-admin.js`
Статус	done

Аргументы запроса (best-effort из хендлера; путь-параметры опущены):

аргументов не обнаружено (подтвердить вручную по server/routes/site-admin.js)

Коды ответов/ошибок (из хендлера): 400 (+ 200) — уточнить причины вручную

Для человека

Как открыть: войдите в Admin Panel (пароль → код TOTP) и откройте раздел «Организации». На экране — список всех организаций платформы.

Показывает все организации сразу, по всей платформе, — в отличие от обычных ролей, которые видят только свою. Для каждой организации видно название, её короткий код (slug) и сколько в ней участников. Отсюда же открываются действия над организацией: создать новую, переименовать, удалить, назначить администратора.

Это рабочая витрина платформенного администратора по организациям — отправная точка для управления ими. Связанная модель «организации и участники» описана в домене Организации.

Кто может. Только администратор платформы. У администратора организации тоже есть свои списки, но они ограничены его собственной организацией; «все организации платформы» — это уровень site-admin.

Для агента

Это операция site-admin, и она недоступна API-токену ни на каком scope. Список всех организаций платформы — администраторская витрина, доступная только под человеческой cookie-сессией.

Путь /api/site-admin/* закрыт для Bearer-токенов в agent-gate (server/auth/agentGate.js): он не в read-allowlist (закрыто по умолчанию), поэтому GET с Authorization: Bearer tak_... возвращает 403 (Forbidden for token). Markdown-зеркала нет. (Агенту доступен лишь срез по своей организации — GET /api/orgs под токеном; это другой эндпоинт и другой scope.)

Под защитой requireSiteAdmin. Браузер шлёт его с cookie-сессией; тела/параметров нет:

curl https://specbuilder.vnimanie.ai/api/site-admin/organizations -b admin-cookies.txt

Ответ 200 — массив организаций (по убыванию даты создания):

[
  {
    "id": "f1e2d3c4-...",
    "name": "Будущее",
    "slug": "buduschee",
    "created_by": "9c8b7a6d-...",
    "created_at": "2026-06-01T10:00:00Z",
    "member_count": 7
  }
]

Связанные

Экраны: Admin Panel
Конвенции · Роли · Ошибки · Глоссарий