метод REST scope: task

task.checklistitem.add

Добавить пункт чек-листа

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

Описание

Метод task.checklistitem.add добавляет новый пункт чек-листа в задаче.

Проверить права на добавление пункта можно методом task.checklistitem.isactionallowed.

Параметры

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

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

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

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

Параметр FIELDS

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

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

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

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

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

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

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

По умолчанию — N

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

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

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

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

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

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

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

  • Если передать PARENT_ID со значением 0, система создаст в задаче новый чек-лист
  • Если в задаче нет пункта чек-листа с указанным PARENT_ID, система создаст новый чек-лист
  • Если не указать PARENT_ID в FIELDS, система добавит новый пункт в существующий верхний чек-лист. Если в задаче нет чек-листа, то создаст новый

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"TASKID":13,"FIELDS":{"TITLE":"Подготовить отчет","PARENT_ID":457,"SORT_INDEX":200,"IS_COMPLETE":"N","IS_IMPORTANT":"Y","MEMBERS":{"547":{"TYPE":"A"}}}}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/task.checklistitem.add

Ответ

HTTP-статус: 200

{
    "result": 475,
    "time": {
        "start": 1762431907,
        "finish": 1762431908.259832,
        "duration": 1.2598319053649902,
        "processing": 0,
        "date_start": "2025-11-06T15:25:07+03:00",
        "date_finish": "2025-11-06T15:25:08+03:00",
        "operating_reset_at": 1762432508,
        "operating": 0.24803590774536133
    }
}

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

result integer

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

time time

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

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

HTTP-статус: 400

{
    "error":"ERROR_CORE",
    "error_description":"TASKS_ERROR_EXCEPTION_#8; Добавление элемента: действие недоступно; 8\/TE\/ACTION_FAILED_TO_BE_PROCESSED\u003Cbr\u003E"
}
Код Описание Значение
ERROR_CORE TASKS_ERROR_EXCEPTION_#8; Добавление элемента: действие недоступно; 8\/TE\/ACTION_FAILED_TO_BE_PROCESSED\u003Cbr\u003E Нет доступа к задаче или недостаточно прав, чтобы работать с чек-листами в задаче
ERROR_CORE TASKS_ERROR_EXCEPTION_#256; Param #0 (taskId) for method ctaskchecklistitem::add() expected to be of type "integer", but given something else.; 256/TE/WRONG_ARGUMENTS Не передан обязательный параметр TASKID или указан неверный тип значения для TASKID
ERROR_CORE TASKS_ERROR_EXCEPTION_#256; Param #1 (arFields) expected by method ctaskchecklistitem::add(), but not given.; 256\/TE\/WRONG_ARGUMENTS\u003Cbr\u003E Не передан обязательный параметр FIELDS или передан пустой
ERROR_CORE TASKS_ERROR_EXCEPTION_#8; Не указано название элемента; 8\/TE\/ACTION_FAILED_TO_BE_PROCESSED\u003Cbr\u003E Не передано обязательное поле TITLE в параметре FIELDS

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

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