метод REST scope: crm

crm.status.update

Обновить элемент справочника

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

Описание

Метод crm.status.update обновляет параметры существующего элемента справочника.

Параметры

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

Идентификатор элемента справочника, который нужно обновить. Получить список можно методом crm.status.list

fields object обязательный

Массив полей для обновления. Список доступных полей описан ниже

Параметр fields

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

Название

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

Сортировка

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

Цвет hex-код, например #39A8EF

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

curl -X POST \
     -H "Content-Type: application/json" \
     -H "Accept: application/json" \
     -d '{"id":123,"fields":{"NAME":"Новое название","COLOR":"#00A9F4"}}' \
     https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/crm.status.update

Ответ

HTTP-статус: 200

{
    "result": true,
    "time": {
        "start": 1752149050.805837,
        "finish": 1752149050.842422,
        "duration": 0.036585092544555664,
        "processing": 0.009345054626464844,
        "date_start": "2025-07-10T15:04:10+03:00",
        "date_finish": "2025-07-10T15:04:10+03:00",
        "operating_reset_at": 1752149650,
        "operating": 0
    }
}

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

result boolean

Корневой элемент ответа, содержит true в случае успеха

time time

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

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

HTTP-статус: 400

{
    "error": "Invalid identifier.",
    "error_description": "Передан некорректный идентификатор."
}
Код Описание Значение
400 Access denied. Нет прав на выполнение операции
400 Invalid identifier. Передан некорректный идентификатор
400 Status is not found. Элемент не найден
400 Error on updating status. Ошибка при обновлении элемента

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

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