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
try
{
const response = await $b24.callMethod(
'bizproc.robot.delete',
{
'CODE': 'test_robot'
}
);
const result = response.getData().result;
alert("Успешно: " + result);
}
catch( error )
{
alert('Error: ' + error);
}
from b24pysdk.errors import BitrixAPIError, BitrixSDKException
try:
bitrix_response = client.bizproc.robot.delete(
code="test_robot",
).response
result = bitrix_response.result
print(result)
except BitrixAPIError as error:
print(
"Ошибка Bitrix API",
f"error: {error.error}",
f"error_description: {error.error_description}",
sep="\n",
)
except BitrixSDKException as error:
print(f"Ошибка Bitrix SDK: {error.message}")
except Exception as error:
print(f"Непредвиденная ошибка: {error}")
try {
$robotCode = 'your_robot_code_here'; // Replace with the actual robot code
$result = $serviceBuilder
->getBizProcScope()
->robot()
->delete($robotCode);
if ($result->isSuccess()) {
print("Robot deleted successfully.");
} else {
print("Failed to delete robot.");
}
} catch (Throwable $e) {
print("Error: " . $e->getMessage());
}
BX24.callMethod(
'bizproc.robot.delete',
{
'CODE': 'test_robot'
},
function(result) {
if(result.error())
alert('Error: ' + result.error());
else
alert("Успешно: " + result.data());
}
);
require_once('crest.php');
$result = CRest::call(
'bizproc.robot.delete',
[
'CODE' => 'test_robot'
]
);
echo '<PRE>';
print_r($result);
echo '</PRE>';
// client и ctx уже созданы — см. раздел «SDK для Go»
res, err := client.Core().Call(ctx, "bizproc.robot.delete", b24.Params{
"CODE": "test_robot",
})
if err != nil {
return fmt.Errorf("bizproc.robot.delete: %w", err)
}
var ok bool
if err := json.Unmarshal(res.Result, &ok); err != nil {
return fmt.Errorf("разбор ответа: %w", err)
}
fmt.Println("выполнено:", ok)
Ответ
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! | Робот не найден |

