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

Участники рабочих групп

Меняют состав рабочей группы: добавляют и удаляют участников, назначают модераторов, рассылают приглашения и передают владение. Права на каждое действие Битрикс24 проверяет у пользователя, от имени которого действует ключ.

Битрикс24 API: sonet_group.user.*, sonet_group.setowner Скоуп: sonet_group

Добавить участников

POST /v1/workgroups/:groupId/users

Добавляет пользователей в рабочую группу сразу, без приглашения и подтверждения с их стороны. Добавленные получают роль участника.

Параметры

Параметр	Тип	Обяз.	Описание
`groupId` (path)	number	да	Идентификатор рабочей группы — положительное целое число. Список: `GET /v1/workgroups`

Поля запроса (body)

Поле	Тип	Обяз.	Описание
`userIds`	number[]	да	Непустой массив идентификаторов пользователей — положительных целых чисел. Строки вида `"93"` не принимаются. Список: `GET /v1/users`

Примеры

curl — личный ключ

Terminal

curl -X POST "https://vibecode.bitrix24.tech/v1/workgroups/157/users" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"userIds": [93]}'

curl — OAuth-приложение

Terminal

curl -X POST "https://vibecode.bitrix24.tech/v1/workgroups/157/users" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"userIds": [93]}'

JavaScript — личный ключ

javascript

const res = await fetch('https://vibecode.bitrix24.tech/v1/workgroups/157/users', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ userIds: [93] }),
})

const body = await res.json()
if (!body.success && body.error.code === 'BITRIX_ERROR') {
  if (Array.isArray(body.error.processedUserIds)) {
    // Часть пользователей могла добавиться — изменения не откатываются
    console.log('Добавлены:', body.error.processedUserIds)
    console.log('Не добавлены:', body.error.skippedUserIds)
  } else {
    // Второй вариант 422: Битрикс24 отказал в вызове, массивов в ответе нет
    console.log('Битрикс24 отказал:', body.error.message)
  }
}

JavaScript — OAuth-приложение

javascript

const res = await fetch('https://vibecode.bitrix24.tech/v1/workgroups/157/users', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ userIds: [93] }),
})

const body = await res.json()

Поля ответа

Поле	Тип	Описание
`success`	boolean	`true`, когда добавлены все запрошенные пользователи
`data.groupId`	number	Идентификатор рабочей группы
`data.processedUserIds`	number[]	Идентификаторы добавленных пользователей. Повторы из `userIds` схлопываются в один
`data.skippedUserIds`	number[]	В успешном ответе всегда пустой массив. Если добавить удалось не всех, приходит `422 BITRIX_ERROR`, а оба массива переезжают в `error`. Это единственный ответ с массивами: у второго `422 BITRIX_ERROR` — когда Битрикс24 отказал в вызове — в `error` только его собственный текст, без `processedUserIds` и `skippedUserIds`

Пример ответа

JSON

{
  "success": true,
  "data": {
    "groupId": 157,
    "processedUserIds": [93],
    "skippedUserIds": []
  }
}

Пример ответа при ошибке

422 — пользователь уже состоит в группе, добавлять некого: