Удаление участников из группового чата или канала

Для корректной работы ваших чат-ботов и мини-приложений направляйте запросы на домен platform-api2.max.ru вместо platform-api.max.ru. Также убедитесь, что добавили сертификат Минцифры в список доверенных

DELETE/chats/{chatId}/members

Удаляет участника из группового чата или канала

Бот, чей токен access_token используется для авторизации, должен быть администратором этого чата или канала с соответствующим правом add_remove_members. Чтобы получить информацию о правах бота, используйте GET /chats/-chatId-/members/admins. Подробнее о правах — в описании POST /chats/{chatId}/members/admins

Пример запроса:

BASH

Скопировать

curl -X DELETE "https://platform-api2.max.ru/chats/{chatId}/members?user_id={user_id}&block=true" \
  -H "Authorization: {access_token}"

Авторизация

access_token
apiKey

Передача токена через query-параметры больше не поддерживается — используйте заголовок Authorization: <token>

Токен для вызова HTTP-запросов присваивается при создании бота — его можно найти на платформе в разделе Чат-боты → Перейти → Расширенные настройки → Настроить
Eсли вы верифицировали профиль и создали бота в мини-приложении «MAX для бизнеса», получить токен можно там же или в боте «MAX для бизнеса» с помощью команды Получить токен

Рекомендуем не разглашать токен посторонним, чтобы они не получили доступ к управлению ботом. Токен может быть отозван за нарушение Правил платформы

Параметры

chatId
integer <int64>
\-?\d+

ID группового чата или канала

user_id
integer <int64>

ID пользователя, которого нужно удалить из группового чата или канала

block
boolean optional

Если передать true, пользователь будет заблокирован в чате. Применяется только для чатов с публичной или приватной ссылкой. Игнорируется в остальных случаях

Результат

success
boolean

true, если запрос был успешным, false — в противном случае

message
string optional

Сообщение об ошибке

Коды ответов

Код	Описание
`200`	Объект удалён или запрос завершился ошибкой (причина ошибки описана в `message`)
`401`	Ошибка авторизации. Токен `access_token` указан некорректно или недействителен
`403`	Ошибка доступа. У вас нет прав на доступ к этому ресурсу
`500`	Внутренняя ошибка сервера