GET /api/orgs — Мои организации
Сгенерировано из матриц + кода. Правки вносить в источники (
docs/matrices/,server/routes/), не здесь.
| Поле | Значение |
|---|---|
| HTTP | GET /api/orgs |
| Auth | — |
| Scope токена | read |
| PG-функции | api.list_my_orgs |
| Таблицы | — |
| SRM | — (вне SRM, документировано по коду) |
| RP (права) | — |
| Файл роута | server/routes/orgs.js |
| Статус | по коду (вне SRM) |
Аргументы запроса (best-effort из хендлера; путь-параметры опущены):
аргументов не обнаружено (подтвердить вручную по server/routes/orgs.js)
Коды ответов/ошибок (из хендлера): 400 (+ 200) — уточнить причины вручную
Для человека
Как открыть: список ваших организаций виден в переключателе активной организации — в правой части верхней панели. Нажмите на название текущей организации, чтобы развернуть выпадающий список и переключиться на другую.
Возвращает все организации, в которых вы состоите, — вместе с вашей ролью в каждой (участник или администратор). Это та опора, на которой строятся переключатель активной организации и личный кабинет: пока вы не состоите ни в одной организации, список пуст.
Гость организаций не имеет: список доступен только вошедшему пользователю и показывает строго ваше членство, без чужих организаций.
Для агента
Чтение — достаточно токена со scope read (см. Конвенции). Возвращает организации владельца токена; ничего, кроме его собственного членства, эндпоинт не раскрывает. Тела и путь-параметров нет.
Пример запроса:
curl https://specbuilder.vnimanie.ai/api/orgs \ -H "Authorization: Bearer tak_..."Ответ 200 — массив организаций, отсортированный по названию:
[ { "id": "0c8f1e2a-...", "name": "Будущее", "slug": "buduschee", "my_role": "admin", "created_at": "2026-01-12T09:30:00.000Z", "updated_at": "2026-05-04T14:02:11.000Z" }]my_role — ваша роль в этой организации (admin — администратор, member — участник).
В отличие от карточки организации, этот список Markdown-зеркала не отдаёт: ответ всегда JSON, даже под токеном с Accept: text/markdown. Чтобы узнать, какая организация активна, используйте whoami (GET /api/users/me); сменить активную — POST /api/users/me/active-org.