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

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

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

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

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

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

integer
required
Количество фактически удаленных участников группы. Если пользователь не был участником группы, он не учитывается в этом числе.

Взаимодействие с автоматическим назначением

Удаление через API считается ручным и блокирует последующее автоматическое назначение: для каждого удалённого пользователя создаётся исключение с причиной «удалён из группы вручную». Правила назначения по оргструктуре больше не вернут его в эту группу.Исключения создаются только для корпоративных групп, в которых настроено автоматическое назначение. Снять блокировку можно, добавив пользователя обратно через добавление участников — это очищает исключение.
Если вы синхронизируете состав групп из внешней системы (например, из 1С), учитывайте это при регулярной выгрузке: удаление участника на одной итерации синхронизации навсегда исключит его из автоматического назначения, пока он не будет добавлен обратно через API.

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

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

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