Skip to main content
Это операция добавления нескольких пользователей в группу одновременно. Если пользователь уже является участником группы, он не будет добавлен повторно.
При добавлении пользователей в группу автоматически создаются связанные записи участников и доступов. Если пользователь уже является участником группы, он не будет добавлен повторно.

Заголовки запроса

string
required
API токен сервисного пользователя в формате Bearer. Получите токен в панели администратора школы. Формат: Bearer YOUR_TOKEN.
string
required
Уникальный идентификатор продавца в системе. Используется для разграничения доступа между разными продавцами.
string
required
Уникальный идентификатор школы в системе. Определяет контекст выполнения операции.
Требуется аутентификация и право SchoolManageUsers.

Параметры запроса

Максимальное количество пользователей, которое можно добавить за один запрос — 250. Для добавления большего количества пользователей используйте несколько запросов.
array
required
Массив идентификаторов пользователей для добавления в группу. Максимум 250 пользователей за один запрос.
Если пользователь уже является участником группы, он не будет добавлен повторно. В ответе будет указано, какие пользователи уже существуют в группе, а какие были добавлены.

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

array
Массив пользователей, которые уже являются участниками группы.
array
Массив пользователей, которые были добавлены в группу. Каждый элемент имеет ту же структуру, что и элементы массива exist.
array
Массив пользователей, пропущенных из-за исключения из автоматического назначения. Элементы — объекты пользователя (та же структура, что и вложенный user в элементах exist).Для этого метода массив всегда пустой: исключения ограничивают только автоматическое назначение по правилам оргструктуры, а добавление через API считается ручным. Поле присутствует в ответе всегда — учитывайте его при строгой валидации схемы.
Ручное добавление снимает ранее выставленное исключение: если пользователя до этого убрали из группы вручную, после добавления через API правила автоматического назначения снова смогут его назначать.

Требования к правам доступа

Для добавления участников в группу требуется право на управление пользователями школы.
Сервисный пользователь должен быть аутентифицирован по токену и иметь соответствующие права доступа к указанной школе.

Обновлено: 2026-08-03 00:05 UTC