метод REST scope: task

tasks.template.checklist.list

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

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

Описание

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

Параметры

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

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

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

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

Фильтр выборки пунктов чек-листа вида { "поле": "значение", ... }.

Фильтровать можно по полям:
- ID — идентификатор пункта чек-листа
- TEMPLATE_ID — идентификатор шаблона задачи
- PARENT_ID — идентификатор родительского пункта
- TITLE — текст пункта чек-листа
- SORT_INDEX — индекс сортировки
- IS_COMPLETE — статус выполнения пункта
- IS_IMPORTANT — отметка важности пункта

Параметр templateId принудительно добавляется в фильтр как TEMPLATE_ID, даже если в filter передано другое значение

select array необязательный

Список полей для выборки.

В выборке можно указать поля:
- ID — идентификатор пункта чек-листа
- TEMPLATE_ID — идентификатор шаблона задачи
- PARENT_ID — идентификатор родительского пункта
- TITLE — текст пункта чек-листа
- SORT_INDEX — индекс сортировки
- IS_COMPLETE — статус выполнения пункта
- IS_IMPORTANT — отметка важности пункта
- MEMBERS — список участников пункта
- ATTACHMENTS — список вложений пункта

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

Объект для сортировки результата вида { "поле": "значение сортировки", ... }.

Сортировать можно по полям:
- ID — идентификатор пункта чек-листа
- PARENT_ID — идентификатор родительского пункта
- CREATED_BY — идентификатор автора пункта
- TITLE — текст пункта чек-листа
- SORT_INDEX — индекс сортировки
- IS_COMPLETE — статус выполнения пункта
- IS_IMPORTANT — отметка важности пункта
- TOGGLED_BY — идентификатор пользователя, который последний раз сменил статус пункта
- TOGGLED_DATE — дата и время изменения статуса пункта

Направление сортировки может принимать значения:
- asc — по возрастанию
- desc — по убыванию

По умолчанию результат сортируется по ID в порядке убывания

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
  "templateId": 139,
  "filter": {
    "IS_COMPLETE": "N",
    "IS_IMPORTANT": "N"
  },
  "select": [
    "ID",
    "TEMPLATE_ID",
    "PARENT_ID",
    "TITLE",
    "SORT_INDEX",
    "IS_COMPLETE",
    "IS_IMPORTANT"
  ],
  "order": {
    "SORT_INDEX": "asc",
    "ID": "desc"
  }
}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/tasks.template.checklist.list

Ответ

HTTP-статус: 200

{
    "result": {
        "checkListItems": {
            "23": {
                "id": "23",
                "templateId": "139",
                "parentId": 0,
                "title": "Что нужно сделать",
                "sortIndex": "0",
                "isComplete": "N",
                "isImportant": "N"
            },
            "27": {
                "id": "27",
                "templateId": "139",
                "parentId": "23",
                "title": "2. Заполнить форму отчета",
                "sortIndex": "1",
                "isComplete": "N",
                "isImportant": "N"
            },
            "29": {
                "id": "29",
                "templateId": "139",
                "parentId": "23",
                "title": "3. Отправить отчет руководителю",
                "sortIndex": "3",
                "isComplete": "N",
                "isImportant": "N"
            },
            "25": {
                "id": "25",
                "templateId": "139",
                "parentId": "23",
                "title": "1. Собрать данные",
                "sortIndex": "4",
                "isComplete": "N",
                "isImportant": "N"
            }
        }
    },
    "time": {
        "start": 1773316805,
        "finish": 1773316806.016895,
        "duration": 1.016895055770874,
        "processing": 0,
        "date_start": "2026-03-12T15:00:05+03:00",
        "date_finish": "2026-03-12T15:00:06+03:00",
        "operating_reset_at": 1773317406,
        "operating": 0
    }
}

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

result object

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

time time

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

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

HTTP-статус: 400

{
    "error": "0",
    "error_description": "Доступ к шаблону задачи запрещен"
}
Код Описание Значение
400 0 Доступ к шаблону задачи запрещен
400 100 Could not find value for parameter {templateId}

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

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