метод REST scope: im

im.disk.file.delete

Удалить файл из папки чата

Кто может выполнять: участник чата, который отправил файл

Описание

Метод относится к группе im.disk.* предыдущего поколения API мессенджера. Замены в im.v2 у него пока нет — используйте этот метод.

Метод im.disk.file.delete удаляет файл из папки чата. Удалить файл может только пользователь — участник чата, который отправил файл. Другие участники чата не могут удалить файл.

После удаления в чате вместо файла отображается текст *Сообщение удалено*.

Параметры

CHAT_ID integer обязательный

Идентификатор чата

FILE_ID integer обязательный

Идентификатор файла

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

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"CHAT_ID":1489,"FILE_ID":5163}' \
  https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/im.disk.file.delete

Ответ

HTTP-статус: 200

{
    "result": true,
    "time": {
        "start": 1772194631,
        "finish": 1772194631.786718,
        "duration": 0.7867178916931152,
        "processing": 0,
        "date_start": "2026-02-27T15:17:11+03:00",
        "date_finish": "2026-02-27T15:17:11+03:00",
        "operating_reset_at": 1772195231,
        "operating": 0.2657620906829834
    }
}

Возвращаемые данные

result boolean

Возвращает true:
- если файл успешно удален,
- пользователь является участником чата, но не отправлял файл. Файл в этом случае не удалится.

Метод возвращает false:
- если у пользователя нет доступа к чату,
- указан неверный CHAT_ID или FILE_ID

time time

Информация о времени выполнения запроса

Обработка ошибок

HTTP-статус: 400

{
    "error": "FILE_ID_EMPTY",
    "error_description": "File ID can't be empty"
}
Код Описание Значение
400 CHAT_ID_EMPTY Chat ID can't be empty
400 FILE_ID_EMPTY File ID can't be empty

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.