GET /api/orgs/:orgId — Организация

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

Поле	Значение
HTTP	`GET /api/orgs/:orgId`
Auth	`—`
Scope токена	`read`
PG-функции	`api.get_org_details`
Таблицы	`organization`, `org_member`
SRM	SRM-058
RP (права)	RP-060, RP-066
Файл роута	`server/routes/orgs.js`
Статус	done

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

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

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

Для человека

Как открыть: в переключателе активной организации на верхней панели выберите нужную организацию и перейдите на вкладку «Организация» — откроется экран организации с её карточкой.

Возвращает карточку одной организации: название, слаг, список участников (с их ролями и e-mail) и командные спейсы организации. Это основа экрана организации — заголовок, список людей и навигация по спейсам.

Видеть карточку может только участник этой организации. Запрос к организации, в которой вы не состоите, возвращает 403 — ровно как если бы её не существовало, чтобы по коду ответа нельзя было выяснить чужой состав. Просмотр карточки не требует прав администратора: участнику она доступна на чтение, а управлять (приглашать, менять роли, удалять) может только администратор организации.

Для агента

Чтение — токен со scope read. Путь-параметр :orgId — UUID организации. Видна только организация, в которой состоит владелец токена; для остальных — 403 (его поднимает PG-функция, а не маршрут).

Пример запроса:

curl https://specbuilder.vnimanie.ai/api/orgs/0c8f1e2a-... \
  -H "Authorization: Bearer tak_..."

Ответ 200 (JSON, cookie-клиент):

{
  "org": {
    "id": "0c8f1e2a-...",
    "name": "Будущее",
    "slug": "buduschee",
    "created_by": "8a1b...",
    "created_at": "2026-01-12T09:30:00.000Z",
    "updated_at": "2026-05-04T14:02:11.000Z"
  },
  "myRole": "admin",
  "members": [
    { "user_id": "8a1b...", "role": "admin", "email": "lead@example.com", "display_name": "Лид", "joined_at": "2026-01-12T09:30:00.000Z" }
  ],
  "spaces": [ { "id": "f9e8...", "name": "Команда А" } ]
}

Это один из немногих org-эндпоинтов с Markdown-зеркалом (server/agent/negotiate.js). Токен с Accept: text/markdown (или ?format=md) получает компактную проекцию ресурса org — поля name, slug, my_role, число спейсов — и блок ## Actions. У ответа есть ETag; повтор с If-None-Match и совпавшим тегом → 304 без тела.

curl https://specbuilder.vnimanie.ai/api/orgs/0c8f1e2a-... \
  -H "Authorization: Bearer tak_..." \
  -H "Accept: text/markdown"

Единственная аффорданса для read-токена (server/agent/affordances.js, kind org):

GET /api/orgs/{id} — read-org — returns this organization

Управляющие действия (приглашения, роли, удаление участников) в блок ## Actions read-токена не попадают: это запись, она доступна только токену со scope read_write под ролью администратора организации.

Связанные

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