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

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

string
обязательно
API-токен сервисного пользователя в формате Bearer YOUR_TOKEN. Токен выпускает владелец школы в кабинете: Управление → Школа → Для разработчиков → API-ключи — подробнее в разделе «Аутентификация».
integer
обязательно
Числовой ID продавца — аккаунта, которому принадлежит школа. Скопируйте его на странице API-ключи в карточке «Данные для интеграции → Идентификаторы». По этому ID проверяются права токена.
integer
обязательно
Числовой ID школы, берётся там же, где Seller-Id. Значение должно совпадать со школой продавца — иначе вернётся ошибка 400 с cause: "ForbiddenSchoolMismatch".
Требуется аутентификация и право «Управление пользователями школы» (SchoolManageUsers).

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

Максимальное количество пользователей, которое можно удалить за один запрос — 250. Для удаления большего количества пользователей используйте несколько запросов.
integer
обязательно
ID группы — поле groupId из списка групп.
integer[]
обязательно
Массив числовых ID пользователей в Exode (не ID записей участников id из списка участников, а их userId). Максимум 250 пользователей за один запрос.
Если пользователь не является участником группы, он будет проигнорирован. В ответе будет указано количество фактически удаленных участников.

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

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

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

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

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

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

Обновлено: 2026-09-25 13:43 UTC