метод REST scope: crm

crm.activity.todo.updateColor

Обновить цвет универсального дела

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

Описание

Метод crm.activity.todo.updateColor обновляет цвет универсального дела.

Параметры

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

Идентификатор обновляемого дела, например 999

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

Идентификатор типа объекта CRM, к которому привязано дело, например 2 для сделки

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

Идентификатор элемента CRM, к которому привязано дело, например, 1

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

Идентификатор цвета дела в таймлайне, например 1. Для выбора доступно 8 цветов, значения от 1 до 7 и цвет по умолчанию, если ничего не указано:

!Доступные цвета

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"id":999,"ownerTypeId":2,"ownerId":1,"colorId":"3"}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/crm.activity.todo.updateColor

Ответ

HTTP-статус: 200

{
    "result": {
        "id": 999
    },
    "time": {
       "start": 1724068028.331234,
        "finish": 1724068028.726591,
        "duration": 0.3953571319580078,
        "processing": 0.13033390045166016,
        "date_start": "2025-01-21T13:47:08+02:00",
        "date_finish": "2025-01-21T13:47:08+02:00",
        "operating": 0
    }
}

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

result object

В случае успеха возвращает объект, содержащий идентификатор обновлённого дела id, в случае ошибки = null

time time

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

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

HTTP-статус: 400

{
    "error": "NOT_FOUND",
    "error_description": "Not found."
}
Код Описание Значение
100 Не переданы обязательные поля
NOT_FOUND Элемент CRM не найден
ACCESS_DENIED Недостаточно прав для выполнения операции
OWNER_NOT_FOUND Владелец элемента не найден
CAN_NOT_UPDATE_COLOR_COMPLETED_TODO Невозможно изменить цвет в закрытом деле
CAN_NOT_UPDATE_WRONG_COLOR_TODO Некорректное значение цвета

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

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