метод REST scope: crm

crm.item.delete

Удалить элемент

Кто может выполнять: любой пользователь с правом «удаление» элементов объекта CRM

Описание

Метод удаляет элемент объекта CRM по идентификатору элемента и идентификатору типа элемента

Параметры

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

Идентификатор системного или пользовательского типа, чей элемент мы хотим удалить.

Числовые значения для системных типов (Лид — 1, Сделка — 2, Контакт — 3, Компания — 4, Счёт — 31 и др.) приведены в справочнике типов объектов CRM. Идентификатор смарт-процесса можно узнать методом crm.type.list

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

Идентификатор элемента, который нужно удалить.

Можно получить методом crm.item.list или при создании элемента crm.item.add

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"entityTypeId":1268,"id":1}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/crm.item.delete

Ответ

HTTP-статус: 200

{
    "result": [],
    "time": {
        "start": 1721657688.755373,
        "finish": 1721657689.65017,
        "duration": 0.8947970867156982,
        "processing": 0.6092040538787842,
        "date_start": "2024-07-22T16:14:48+02:00",
        "date_finish": "2024-07-22T16:14:49+02:00",
        "operating": 0
    }
}

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

result array

Корневой элемент ответа.

Возвращает пустой массив [] в случае успеха

time time

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

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

HTTP-статус: 400

{
    "error": "NOT_FOUND",
    "error_description": "Элемент не найден"
}
Код Описание Значение
allowed_only_intranet_user Действие разрешено только интранет-пользователям Пользователь не является интранет-пользователем
NOT_FOUND Смарт-процесс не найден Возникает, при передаче невалидного entityTypeId
NOT_FOUND Элемент не найден Элемент с переданным id типа entityTypeId не существует
ACCESS_DENIED Доступ запрещен У пользователя нет прав на удаление элементов типа entityTypeId

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

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