## Отметить пункт выполненным вместе с подпунктами `POST /v1/tasks/:taskId/checklist/:itemId/complete-all` Отмечает пункт чек-листа задачи выполненным вместе со всеми его подпунктами за один вызов. Пункт верхнего уровня — это название чек-листа, и его отметка закрывает весь чек-лист. ## Параметры | Параметр | Тип | Обяз. | Описание | |----------|-----|:-----:|----------| | `taskId` (path) | number | да | ID задачи, целое положительное число. Список: [`GET /v1/tasks`](/docs/entities/tasks/list) | | `itemId` (path) | number | да | ID пункта, целое положительное число. Список: [`GET /v1/tasks/:taskId/checklist`](/docs/entities/tasks/checklist/list) | Тело запроса не нужно. ## Примеры ### curl — личный ключ ```bash curl -X POST "https://vibecode.bitrix24.tech/v1/tasks/4218/checklist/268/complete-all" \ -H "X-Api-Key: YOUR_API_KEY" ``` ### curl — OAuth-приложение ```bash curl -X POST "https://vibecode.bitrix24.tech/v1/tasks/4218/checklist/268/complete-all" \ -H "X-Api-Key: YOUR_APP_KEY" \ -H "Authorization: Bearer USER_SESSION_TOKEN" ``` ### JavaScript — личный ключ ```javascript const res = await fetch('https://vibecode.bitrix24.tech/v1/tasks/4218/checklist/268/complete-all', { method: 'POST', headers: { 'X-Api-Key': 'YOUR_API_KEY', }, }) const { success, data } = await res.json() console.log('Отмечено пунктов:', data?.length) ``` ### JavaScript — OAuth-приложение ```javascript const res = await fetch('https://vibecode.bitrix24.tech/v1/tasks/4218/checklist/268/complete-all', { method: 'POST', headers: { 'X-Api-Key': 'YOUR_APP_KEY', 'Authorization': 'Bearer USER_SESSION_TOKEN', }, }) const { success, data } = await res.json() ``` ## Поля ответа | Поле | Тип | Описание | |------|-----|----------| | `success` | boolean | `true`, если запрос выполнен | | `data` | array | Отмеченные пункты: сначала подпункты, последним — сам пункт `itemId`. У пункта без подпунктов — массив из одного пункта | | `data[].id` | number | ID пункта | | `data[].taskId` | number | ID задачи | | `data[].parentId` | number | ID родительского пункта. `0` — пункт верхнего уровня, он же название чек-листа | | `data[].title` | string | Текст пункта | | `data[].sortIndex` | number | Место пункта среди пунктов с тем же родителем. Чем меньше значение, тем выше пункт | | `data[].displaySortIndex` | string | Номер пункта для показа. В ответе — пустая строка | | `data[].isComplete` | boolean | Выполнен ли пункт. После вызова — `true` у каждого пункта массива | | `data[].isImportant` | boolean | Отмечен ли пункт как важный | | `data[].completedCount` | number | Приходит `0`, даже когда подпункты выполнены. Выполнен ли подпункт, показывает его `isComplete` | | `data[].members` | array | Участники пункта. Без участников — пустой массив. Роли участников — в [ключевых полях](/docs/entities/tasks/checklist-actions#ключевые-поля) | | `data[].attachments` | array \| object | Вложения пункта. Без вложений — пустой массив. Формат объекта — в [ключевых полях](/docs/entities/tasks/checklist-actions#ключевые-поля) | | `data[].createdBy` | number | ID автора пункта. Список: [`GET /v1/users`](/docs/entities/users/list) | | `data[].userId` | number | ID сотрудника, от имени которого сделан вызов. Список: [`GET /v1/users`](/docs/entities/users/list) | | `data[].copiedId` | number \| null | ID исходного пункта, если пункт получен копированием. Иначе `null` | | `data[].nodeId` | string \| null | Служебный ключ узла. В ответе — `null` | ## Пример ответа Пункт верхнего уровня с двумя подпунктами отмечен выполненным: ```json { "success": true, "data": [ { "id": 276, "copiedId": null, "userId": 1295, "createdBy": 1295, "parentId": 268, "title": "Проверить сборку", "sortIndex": 1, "displaySortIndex": "", "isComplete": true, "isImportant": true, "completedCount": 0, "members": [], "attachments": [], "nodeId": null, "taskId": 4218 }, { "id": 274, "copiedId": null, "userId": 1295, "createdBy": 1295, "parentId": 268, "title": "Согласовать дату", "sortIndex": 2, "displaySortIndex": "", "isComplete": true, "isImportant": false, "completedCount": 0, "members": [], "attachments": [], "nodeId": null, "taskId": 4218 }, { "id": 268, "copiedId": null, "userId": 1295, "createdBy": 1295, "parentId": 0, "title": "Подготовка к запуску", "sortIndex": 0, "displaySortIndex": "", "isComplete": true, "isImportant": false, "completedCount": 0, "members": [], "attachments": [], "nodeId": null, "taskId": 4218 } ] } ``` ## Пример ответа при ошибке 422 — пункта с таким `itemId` нет: ```json { "success": false, "error": { "code": "BITRIX_ERROR", "message": "Доступ к задаче запрещен", "b24Code": "0" } } ``` ## Ошибки | HTTP | Код | Описание | |------|-----|----------| | 400 | `INVALID_PARAMS` | `taskId` — не целое положительное число. Сообщение `taskId must be a positive integer` | | 400 | `INVALID_PARAMS` | `itemId` — не целое положительное число. Сообщение `itemId must be a positive integer` | | 400 | `FST_ERR_CTP_EMPTY_JSON_BODY` | Передан заголовок `Content-Type: application/json`, а тело пустое. Вызывайте метод без этого заголовка | | 401 | `MISSING_API_KEY` | Не передан `X-Api-Key` | | 401 | `TOKEN_MISSING` | У ключа нет токенов Битрикс24 | | 403 | `SCOPE_DENIED` | У ключа нет скоупа `task` | | 403 | `WRITE_BLOCKED_READONLY_KEY` | Ключ в режиме «только чтение». В `error.details.switchUrl` — адрес раздела, где режим меняется | | 415 | `FST_ERR_CTP_INVALID_MEDIA_TYPE` | Тело с `Content-Type`, который API не разбирает, например `application/xml` | | 422 | `BITRIX_ERROR` | Задачи или пункта нет либо сотрудник, от имени которого идёт вызов, не видит задачу. Сообщение «Доступ к задаче запрещен», на портале с английским языком — `Access to task was denied`. Спецификация API объявляет на этот случай `404 TASK_NOT_FOUND` и `404 NOT_FOUND`, но на проверенных порталах приходит этот ответ | | 429 | `RATE_LIMITED` | Превышена частота запросов. Действующий потолок — в заголовке `x-ratelimit-limit` | Полный список общих ошибок API — [Ошибки](/docs/errors). ## Известные особенности **Повторный вызов не даёт ошибки.** Если пункт и его подпункты уже выполнены, метод снова отвечает `200` и тем же массивом пунктов. ## Смотрите также - [Действия над чек-листом и файл задачи](/docs/entities/tasks/checklist-actions) - [Сохранить чек-лист задачи](/docs/entities/tasks/checklist-actions/tree) - [Переместить пункт перед другим](/docs/entities/tasks/checklist-actions/move-before) - [Переместить пункт после другого](/docs/entities/tasks/checklist-actions/move-after) - [Отметить пункт выполненным](/docs/entities/tasks/checklist/complete) - [Вернуть пункт в работу](/docs/entities/tasks/checklist/renew) - [Список пунктов чек-листа](/docs/entities/tasks/checklist/list) - [Чек-лист задачи](/docs/entities/tasks/checklist)