метод REST scope: bizproc

bizproc.robot.delete

Удалить зарегистрированного робота

Кто может выполнять: администратор

Описание

Метод bizproc.robot.delete удаляет робота, зарегистрированного приложением.

Работает только в контексте приложения.

При удалении или обновлении приложения Битрикс24 удаляет из списка доступных роботов только роботов, зарегистрированных этим приложением. Роботы других приложений и стандартные роботы не затрагиваются. Если робот уже используется в схеме автоматизации, он остается в схеме как недоступный: его можно удалить, но нельзя настроить или выполнить как доступного робота. Под обновлением здесь понимается обновление приложения, а не вызов метода bizproc.robot.update. При повторной установке приложения робот с тем же кодом снова становится доступным.

Параметры

CODE string обязательный

Символьный идентификатор робота приложения

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"CODE":"test_robot","auth":"**put_access_token_here**"}' \
https://**put_your_bitrix24_address**/rest/bizproc.robot.delete

Ответ

HTTP-статус: 200

{
    "result": true,
    "time": {
        "start": 1738150149.8462,
        "finish": 1738150149.8894911,
        "duration": 0.043291091918945312,
        "processing": 0.0053689479827880859,
        "date_start": "2025-01-29T14:29:09+03:00",
        "date_finish": "2025-01-29T14:29:09+03:00",
        "operating_reset_at": 1738150749,
        "operating": 0
    }
}

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

result boolean

Возвращает true, если робот успешно удален

time time

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

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

HTTP-статус: 400

{
    "error": "ERROR_ACTIVITY_NOT_FOUND",
    "error_description": "Activity or Robot not found!"
}
Код Описание Значение
ACCESS_DENIED Application context required Необходим контекст приложения
ACCESS_DENIED Access denied! Метод выполнил не администратор
ERROR_ACTIVITY_VALIDATION_FAILURE Empty activity code! Не указан код робота
ERROR_ACTIVITY_VALIDATION_FAILURE Wrong activity code! Некорректный код робота
ERROR_ACTIVITY_NOT_FOUND Activity or Robot not found! Робот не найден

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

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