метод REST scope: task

tasks.template.checklist.add

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

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

Описание

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

Параметры

templateId 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 — не выполнен

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

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

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

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

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

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

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
  "templateId": 139,
  "fields": {
    "TITLE": "4. Подготовить дашборд",
    "PARENT_ID": 23,
    "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**/tasks.template.checklist.add

Ответ

HTTP-статус: 200

{
    "result": {
        "checkListItem": {
            "id": 37,
            "copiedId": null,
            "userId": 503,
            "createdBy": 503,
            "parentId": 23,
            "title": "4. Подготовить дашборд",
            "sortIndex": 200,
            "displaySortIndex": "",
            "isComplete": false,
            "isImportant": true,
            "completedCount": 0,
            "members": [
                {
                    "type": "A",
                    "id": 547
                }
            ],
            "attachments": [],
            "nodeId": null,
            "templateId": 139
        }
    },
    "time": {
        "start": 1773235651,
        "finish": 1773235651.960878,
        "duration": 0.9608778953552246,
        "processing": 0,
        "date_start": "2026-03-11T16:27:31+03:00",
        "date_finish": "2026-03-11T16:27:31+03:00",
        "operating_reset_at": 1773236251,
        "operating": 0
    }
}

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

result object

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

time time

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

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

HTTP-статус: 400

{
    "error": "0",
    "error_description": "Указано некорректное значение [] для поля [PARENT_ID] в элементе [, Новый пункт]"
}
Код Описание Значение
400 100 Could not find value for parameter {templateId}
400 100 Could not find value for parameter {fields}
400 0 Не указано название элемента
400 0 Указано некорректное значение [] для поля [PARENT_ID] в элементе [, Название пункта]
400 0 Добавление элемента: действие недоступно

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

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