метод REST scope: crm

crm.activity.todo.update

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

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

Описание

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

Параметры

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

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

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

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

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

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

deadline datetime обязательный

Крайний срок дела, например 2025-02-03T15:00:00

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

Название дела

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

Описание дела

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

Идентификатор пользователя, ответственного за дело, например 1

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

Идентификатор дела в таймлайне, с которым можно связать обновляемое дело, например 888

pingOffsets array необязательный

Массив, который содержит целочисленные значения в минутах, позволяющие настроить время напоминания о деле. Например [0, 15] означает, что будет создано 2 напоминания, которые придут за 15 минут до крайнего срока и в момент, когда крайний срок наступить. По умолчанию пустой массив, без напоминаний

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,"deadline":"**put_current_date_here**","title":"Новый заголовок дела","description":"Новое описание дела","responsibleId":1,"pingOffsets":[15,30],"colorId":"7"}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/crm.activity.todo.update

Ответ

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 Владелец элемента не найден
WRONG_DATETIME_FORMAT Некорректный формат даты
CAN_NOT_UPDATE_COMPLETED_TODO Закрытое дело нельзя изменять
ERROR_PARENT_ACTIVITY_RESTRICT Невозможно запланировать дело для закрытого дела

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

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