Для AI-агентов: markdown этой страницы — /docs-content/entities/tasks/checklist/renew.md индекс документации — /llms.txt
Вернуть пункт в работу
POST /v1/tasks/:taskId/checklist/:itemId/renew
Снимает отметку о выполнении пункта чек-листа. Эквивалентно PATCH с телом { "isComplete": false }, но не требует передавать остальные поля.
Параметры
| Параметр | Тип | Обяз. | Описание |
|---|---|---|---|
taskId (path) |
integer | да | ID задачи |
itemId (path) |
integer | да | ID пункта чек-листа |
Тело запроса не требуется.
Примеры
curl — личный ключ
curl -X POST "https://vibecode.bitrix24.tech/v1/tasks/3943/checklist/213/renew" \
-H "X-Api-Key: YOUR_API_KEY"
curl — OAuth-приложение
curl -X POST "https://vibecode.bitrix24.tech/v1/tasks/3943/checklist/213/renew" \
-H "X-Api-Key: YOUR_APP_KEY" \
-H "Authorization: Bearer USER_SESSION_TOKEN"
JavaScript — личный ключ
const res = await fetch("https://vibecode.bitrix24.tech/v1/tasks/3943/checklist/213/renew", {
method: "POST",
headers: { "X-Api-Key": "YOUR_API_KEY" },
});
const { data } = await res.json();
JavaScript — OAuth-приложение
const res = await fetch("https://vibecode.bitrix24.tech/v1/tasks/3943/checklist/213/renew", {
method: "POST",
headers: {
"X-Api-Key": "YOUR_APP_KEY",
"Authorization": "Bearer USER_SESSION_TOKEN",
},
});
const { data } = await res.json();
Поля ответа
| Поле | Тип | Описание |
|---|---|---|
success |
boolean | Всегда true при успехе |
data.id |
number | ID пункта |
data.isComplete |
string | Всегда "N" после успешного вызова |
Пример ответа
{ "success": true, "data": { "id": 213, "isComplete": "N" } }
Пример ответа при ошибке
400 — некорректный itemId:
{
"success": false,
"error": { "code": "INVALID_PARAMS", "message": "taskId and itemId must be positive integers" }
}
Ошибки
| HTTP | Код | Описание |
|---|---|---|
| 400 | INVALID_PARAMS |
taskId или itemId не положительное целое |
| 403 | SCOPE_DENIED |
API-ключ не имеет скоупа task |
| 403 | WRITE_BLOCKED_READONLY_KEY |
Ключ в режиме «только чтение» — переключите на чтение+запись в /keys |
| 401 | TOKEN_MISSING |
API-ключ не имеет настроенных токенов |
Полный список общих ошибок API — Ошибки.
Известные особенности
- Несуществующие
itemIdиtaskIdтоже дают200. В ответе приходит переданныйitemIdиisComplete: "N", даже если такого пункта нет — и даже если нет самой задачи. Успешный статус не подтверждает, что пункт существует и что он возвращён в работу. Проверить наличие можно через «Получить пункт», он отвечает422и на отсутствующий пункт, и на отсутствующую задачу.