Создать чеклист или добавить в него пункты

Запрос позволяет создать чеклист в проекте или портфеле и добавить в него новые пункты. Новые пункты добавляются в конец списка. Подробнее о чеклистах см. в разделе Как создать чеклист.

https://api.tracker.yandex.net/v3/entities/<тип_сущности>/<id_сущности>/checklistItems

Формат запроса

Перед выполнением запроса получите доступ к API.

Чтобы создать чеклист или добавить в него новые пункты, используйте HTTP-запрос с методом POST. Информация о новых пунктах передается в его теле в формате JSON.

POST /v3/entities/<тип_сущности>/<id_сущности>/checklistItems
Host: api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-ID или X-Cloud-Org-ID: <идентификатор_организации>

{
  "text": "Item text",
  "checked": true,
  "assignee": "username",
  "deadline": {
    "date": "2021-05-09T00:00:00.000+0000",
    "deadlineType": "date"
  }
}

Пример: Добавить два пункта в чеклист

• Используется HTTP-метод POST.
• В чеклист добавляется пункт: "First list item".
• В чеклист добавляется пункт: "Second list item", отмеченный как выполненный.
• В ответе выводится информация о всех пунктах чеклиста (fields=checklistItems).

POST /v3/entities/project/<id_проекта>/checklistItems?fields=checklistItems
Host: api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-ID или X-Cloud-Org-ID: <идентификатор_организации>

[
  {
     "text": "First list item"
  },
  {
     "text": "Second list item",
     "checked": true
  }
]

Формат ответа

{
    "self": "https://api.tracker.yandex.net/v3/entities/project/6586d6fee2b9ef74********", 
    "id": "6586d6fee2b9ef74********",
    "version": 133,
    "shortId": 0,
    "entityType": "project",
    "createdBy": {
        "self": "https://api.tracker.yandex.net/v3/users/11********",
        "id": "11********",
        "display": "Имя Фамилия",
        "cloudUid": "ajeppa7dgp53********",
        "passportUid": 11********
    },
    "createdAt": "2023-12-13T15:06:27.231Z",
    "updatedAt": "2023-12-13T15:06:27.231Z",
    "fields": {
        "checklistItems": [
           {
               "id": "6586d91f99a40477********", 
               "text": "First list item", 
               "checked": false, 
               "checklistItemType": "standard"
           },
           {
               "id": "6586d91f99a40477********", 
               "text": "Second list item", 
               "checked": true, 
               "checklistItemType": "standard"
           }
        ]
    }
}