метод REST scope: tasks

tasks.task.update

Изменить задачу v 3.0

Кто может выполнять: постановщик задачи или пользователь с доступом к редактированию задачи

Описание

Метод относится к REST 3.0. Особенности вызова и формат ответа новой версии API описаны в обзоре REST 3.0.

Метод tasks.task.update обновляет задачу.

Параметры

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

Идентификатор задачи.

Идентификатор задачи можно получить при создании новой задачи или методом tasks.task.list

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

Значения полей задачи для обновления.
Описание всех полей задачи

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"id":11,"fields":{"title":"Название задачи","deadline":"2025-12-31T23:59:59+02:00","creatorId":29,"responsibleId":1,"crmItemIds":["L_1000959"]}}' \
https://**put_your_bitrix24_address**/rest/api/**put_your_user_id_here**/**put_your_webhook_here**/tasks.task.update

Ответ

HTTP-статус: 200

{
    "result": {
        "result": true
    },
    "time": {
        "start": 1765452441,
        "finish": 1765452442.17818,
        "duration": 1.1781799793243408,
        "processing": 1,
        "date_start": "2025-12-11T14:27:21+03:00",
        "date_finish": "2025-12-11T14:27:22+03:00",
        "operating_reset_at": 1765453041,
        "operating": 0
    }
}

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

result boolean

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

Содержит объект с ключом result и значением true, если задача обновлена успешно

time time

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

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

HTTP-статус: 400

{
    "error": {
        "code": "BITRIX_REST_V3_EXCEPTION_VALIDATION_REQUESTVALIDATIONEXCEPTION",
        "message": "Ошибка при валидации объекта запроса",
        "validation": [
            {
                "message": "В DTO `TaskDto` в поле `creatorId` требуется наличие атрибута `Editable` для такого запроса",
                "field": "creatorId"
            }
        ]
    }
}
Код Описание Значение
Поле Описание ошибки Как исправить
id fields Обязательное поле #FIELD# не указано Добавьте указанное поле в тело запроса
FIELD# В поле #FIELD# требуется тип данных #TYPE# для такого запроса Убедитесь, что передаваемое значение нужного типа
responsibleId Пользователь указанный в поле \"Исполнитель\" не найден Укажите идентификатор существующего пользователя в поле responsibleId
parentId Задача указанная в поле \"Надзадача\" не найдена Укажите идентификатор существующей задачи в поле parentId
parentId Невозможно привязать узел к самому себе Укажите идентификатор задачи в поле parentId отличный от поля id
endPlan В планировании сроков указана дата окончания меньшая даты старта Укажите дату endPlan больше startPlan
endPlan В планировании сроков указана слишком большая длительность задачи Уменьшите дату в поле endPlan
creatorId В DTO TaskDto в поле creatorId требуется наличие атрибута Editable для такого запроса Удалите поле creatorId из запроса, оно не может быть изменено

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

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