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

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

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

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

Максимальное количество пользователей, которое можно удалить за один запрос — 100. Для удаления большего количества пользователей используйте несколько запросов.
userIds
array
required
Массив идентификаторов пользователей для удаления из группы. Максимум 100 пользователей за один запрос.
Если пользователь не является участником группы, он будет проигнорирован. В ответе будет указано количество фактически удаленных участников.
curl --location --request DELETE 'https://api.exode.biz/saas/v2/group/{{ groupId }}/member/delete-many' \
  --header 'Seller-Id: {{ sellerId }}' \
  --header 'School-Id: {{ schoolId }}' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --data-raw '{
    "userIds": [8, 15, 23]
  }'
{
  "success": true,
  "code": 200,
  "payload": {
    "affected": 1
  }
}

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

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

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

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