28.06.2026 12:20

Leave

[POST] .../v1/chat/leave

Удаляет текущего пользователя из обычного группового чата или канала.

Входные параметры

Название Тип данных Обязательность Описание
id String Обязательный UUID чата

Ограничения и проверки

  • id должен быть корректным UUID существующего чата.
  • Метод доступен только активному участнику чата с типом User.
  • Метод применяется только к обычным групповым чатам и каналам (chat_type = Group или Channel) без связи с бизнес-сущностью.
  • Для чатов типа Individual выход через этот метод запрещен; для скрытия личного чата используйте персональную архивацию.
  • Для entity-чатов (Task/Lead/Deal/Ticket) выход через этот метод запрещен; состав таких чатов управляется связанной сущностью.
  • В канале должен оставаться минимум один активный User/Staff, пока в нем есть другие активные User-участники.
  • Если после выхода остаются активные User-участники, чат продолжает существовать.
  • Если выходит последний активный User-участник, чат удаляется и больше не возвращается в Chat/Get.
  • created_user_id остается ID пользователя, создавшего чат, и не меняется при выходе участников.
  • Событие ChatParticipantsRemoved публикуется и при обычном выходе пользователя, и при удалении чата после выхода последнего активного User-участника.

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

{
  "id": "6f6fdb2f-7d0b-4c34-b6fd-1fbcf40d37ef"
}

Выходные параметры

Название Тип данных Описание
result.row_affected Int64 Количество измененных строк
result.ids Array Для этого метода возвращается null

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

{
  "ok": true,
  "result": {
    "row_affected": 1,
    "ids": null
  }
}