метод REST scope: crm

crm.activity.todo.updateDescription

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

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

Описание

Метод crm.activity.todo.updateDescription меняет описание в универсальном деле.

Параметры

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

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

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

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

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

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

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

Новое описание дела

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"id":999,"ownerTypeId":2,"ownerId":1,"value":"Новое описание дела"}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/crm.activity.todo.updateDescription

Ответ

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_COMPLETED_TODO Закрытое дело нельзя изменять

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

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