метод REST scope: task

tasks.template.checklist.update

Обновить пункт чек-листа шаблона задачи

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

Описание

Метод tasks.template.checklist.update обновляет пункт чек-листа шаблона задачи.

Параметры

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

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

Идентификатор шаблона задачи можно получить при создании нового шаблона

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

Идентификатор пункта чек-листа.

Идентификатор пункта чек-листа шаблона можно получить при создании нового пункта или методом получения списка пунктов

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

Поля для обновления пункта чек-листа (подробное описание)

Параметр fields

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

Текст пункта чек-листа

Если передать PARENT_ID со значением 0, то TITLE — название чек-листа

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

Идентификатор родительского пункта. Используйте для вложенных чек-листов

  • Если передать PARENT_ID со значением 0, система создаст в шаблоне задачи новый чек-лист
  • Если в шаблоне нет пункта чек-листа с указанным PARENT_ID, система создаст новый чек-лист
  • Если переместить главный пункт чек-листа под пункт другого чек-листа, то он переместится вместе со своими подпунктами с сохранением иерархии. Чек-листы объединятся в один
SORT_INDEX integer необязательный

Индекс сортировки. Чем меньше значение, тем выше пункт в списке или подсписке

IS_COMPLETE boolean необязательный

Статус выполнения пункта. Возможные значения:
- Y — выполнен
- N — не выполнен

IS_IMPORTANT boolean необязательный

Отметка, что пункт важный. Возможные значения:
- Y — важный
- N — обычный

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

Объект с описанием участников пункта чек-листа. Ключ — идентификатор пользователя, значение — объект с параметром типа участника TYPE. Возможные значения типа участника:
- 'TYPE': 'A' — соисполнитель
- 'TYPE': 'U' — наблюдатель

Поле MEMBERS заменяется полностью. Чтобы сохранить текущих участников, передайте их вместе с новыми значениями

Система добавит участников пункта чек-листа в задачу в тех же ролях

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
  "templateId": 139,
  "checkListItemId": 37,
  "fields": {
    "TITLE": "4. Подготовить дашборд и отправить ссылку"
  }
}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/tasks.template.checklist.update

Ответ

HTTP-статус: 200

{
    "result": {
        "checkListItem": {
            "id": 37,
            "copiedId": null,
            "userId": 503,
            "createdBy": null,
            "parentId": 23,
            "title": "4. Подготовить дашборд и отправить ссылку",
            "sortIndex": 3,
            "displaySortIndex": "",
            "isComplete": false,
            "isImportant": true,
            "completedCount": 0,
            "members": [
                {
                    "id": "547",
                    "type": "A",
                    "name": "Анна Петрова",
                    "personalPhoto": "57129",
                    "personalGender": "",
                    "image": "https://mysite.ru/b17053/resize_cache/57129/c0120a8d7c10d63c83e32398d1ec4d9e/main/137/137bfa78b877be117e75f1ac8652834a/anna.png",
                    "isCollaber": false
                }
            ],
            "attachments": [],
            "nodeId": null,
            "templateId": 139
        }
    },
    "time": {
        "start": 1773238088,
        "finish": 1773238088.917228,
        "duration": 0.9172279834747314,
        "processing": 0,
        "date_start": "2026-03-11T17:08:08+03:00",
        "date_finish": "2026-03-11T17:08:08+03:00",
        "operating_reset_at": 1773238688,
        "operating": 0
    }
}

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

result object

Объект с данными ответа (подробное описание)

time time

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

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

HTTP-статус: 400

{
    "error": "100",
    "error_description": "Could not find value for parameter {templateId}"
}
Код Описание Значение
400 100 Could not find value for parameter {templateId}
400 100 Bitrix\Tasks\CheckList\Internals\CheckList All parameters in the constructor must have real class type
400 100 Could not find value for parameter {fields}
400 0 Bitrix\Tasks\CheckList\CheckListFacade::onAfterUpdate(): Argument #1 ($taskId) must be of type int, string given, called in /var/www/html/bitrix/modules/tasks/lib/checklist/checklistfacade.php on line 313
400 0 Указано некорректное значение [] для поля [ENTITY_ID] в элементе [, Название пункта]
400 0 Изменение элемента: действие недоступно

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

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