Для AI-агентов: markdown этой страницы — /docs-content/me/workgroups.md индекс документации — /llms.txt

Мои рабочие группы

GET /v1/me/workgroups оборачивает sonet_group.user.groups. Требуется sonet_group; READONLY разрешён. Параметров и пагинации нет. Возвращается весь список членства действующего пользователя ключа, а не произвольного сотрудника: вебхук действует от владельца, OAuth с сессией — от пользователя сессии.

Ответ

JSON

{"success":true,"data":[{"groupId":85,"groupName":"VIBE-PROBE","role":"owner","groupImageId":0,"groupImage":"","isExtranet":false}],"meta":{"total":1}}

Роли A, E, K преобразуются в owner, moderator, member. groupImage — ссылка изображения Б24, не загрузка через V1; строки с кредами удаляются общим санитайзером. Пустой список корректен. Членство — не решение о правах: Б24 проверяет права при действии.

Ошибки

403 SCOPE_DENIED до Б24; 422 BITRIX_ERROR — бизнес-отказ; 502 BITRIX_UNAVAILABLE — нечитаемый ответ или неизвестная роль; 429 — лимит; 503 — таймаут.

Управление участниками