[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-entities\u002Ftasks\u002Fupdate":3,"docs-tabs-entities\u002Ftasks\u002Fupdate":6},{"content":4,"lastmod":5},"\n## Обновить задачу\n\n`PATCH \u002Fv1\u002Ftasks\u002F:id`\n\nОбновляет поля существующей задачи. Передавайте только изменяемые поля. Полный список — [Поля задачи](.\u002Ffields.md).\n\n## Параметры\n\n| Параметр | Тип | Обяз. | Описание |\n|----------|-----|:-----:|---------|\n| `id` (path) | number | да | ID задачи |\n\n## Поля запроса (body)\n\nПередавайте только изменяемые поля — поведение PATCH, остальные значения не затрагиваются.\n\n| Поле | Тип | Описание |\n|------|-----|---------|\n| `title` | string | Название |\n| `description` | string | Описание задачи (поддерживает BB-код) |\n| `responsibleId` | number | Новый ответственный. Список сотрудников: `GET \u002Fv1\u002Fusers` |\n| `status` | number | Статус задачи. Полный список значений: `GET \u002Fv1\u002Ftasks\u002Ffields` → `fields.status.enum` |\n| `priority` | number | Приоритет: `0` — низкий, `1` — обычный, `2` — высокий |\n| `deadline` | datetime | Крайний срок (ISO 8601) |\n| `startDatePlan` | datetime | Плановая дата начала |\n| `endDatePlan` | datetime | Плановая дата окончания |\n| `timeEstimate` | number | Оценка трудозатрат в секундах |\n| `groupId` | number | Рабочая группа. Список: `GET \u002Fv1\u002Fworkgroups` |\n| `parentId` | number | Родительская задача. Список: `GET \u002Fv1\u002Ftasks` |\n| `accomplices` | number[] | Соисполнители. Список сотрудников: `GET \u002Fv1\u002Fusers` |\n| `auditors` | number[] | Наблюдатели. Список сотрудников: `GET \u002Fv1\u002Fusers` |\n| `tags` | string[] | Метки задачи |\n\nПоля `id`, `dateStart`, `createdDate`, `changedDate`, `closedDate`, `activityDate` — read-only, в body не передаются. Поле `createdBy` (постановщик) задаётся только при создании ([`POST \u002Fv1\u002Ftasks`](.\u002Fcreate.md)) — в PATCH отклоняется. Попытка → `400 READONLY_FIELD`.\n\n## Часто обновляемые поля\n\n| Поле | Когда используется |\n|------|-------------------|\n| `status` | Закрытие (`5`), возврат в работу (`3`), отказ (`7`). Расшифровка: `GET \u002Fv1\u002Ftasks\u002Ffields` → `fields.status.enum` |\n| `responsibleId` | Передача задачи другому сотруднику. Источник: `GET \u002Fv1\u002Fusers` |\n| `deadline` | Перенос срока (ISO 8601 со смещением часового пояса портала) |\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl -X PATCH \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Ftasks\u002F3871\" \\\n  -H \"X-Api-Key: YOUR_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"status\": 5,\n    \"priority\": 2\n  }'\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl -X PATCH \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Ftasks\u002F3871\" \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"status\": 5,\n    \"priority\": 2\n  }'\n```\n\n### JavaScript — личный ключ\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Ftasks\u002F3871', {\n  method: 'PATCH',\n  headers: {\n    'X-Api-Key': 'YOUR_API_KEY',\n    'Content-Type': 'application\u002Fjson',\n  },\n  body: JSON.stringify({\n    status: 5,\n    priority: 2,\n  }),\n})\n\nconst { success, data } = await res.json()\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Ftasks\u002F3871', {\n  method: 'PATCH',\n  headers: {\n    'X-Api-Key': 'YOUR_APP_KEY',\n    'Authorization': 'Bearer USER_SESSION_TOKEN',\n    'Content-Type': 'application\u002Fjson',\n  },\n  body: JSON.stringify({\n    status: 5,\n    priority: 2,\n  }),\n})\n\nconst { success, data } = await res.json()\n```\n\n## Поля ответа\n\n| Поле | Тип | Описание |\n|------|-----|---------|\n| `success` | boolean | Всегда `true` при успехе |\n| `data` | object | Обновлённый объект задачи со всеми полями — см. [Поля задачи](.\u002Ffields.md) |\n\n## Пример ответа\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"id\": \"3871\",\n    \"title\": \"Подготовить отчёт за квартал\",\n    \"status\": \"5\",\n    \"priority\": \"2\",\n    \"responsibleId\": \"1\",\n    \"createdBy\": \"1\",\n    \"createdDate\": \"2026-05-12T11:46:12+03:00\",\n    \"changedDate\": \"2026-05-12T13:02:48+03:00\",\n    \"closedDate\": \"2026-05-12T13:02:48+03:00\",\n    \"deadline\": \"2026-05-19T18:00:00+03:00\",\n    \"accomplices\": [],\n    \"auditors\": []\n  }\n}\n```\n\n## Пример ответа при ошибке\n\n400 — попытка изменить read-only поле:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"READONLY_FIELD\",\n    \"message\": \"Field 'createdDate' is read-only and cannot be set\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | Код | Описание |\n|------|-----|---------|\n| 422 | `BITRIX_ERROR` | Битрикс24 отклонил обновление — например, задача с таким ID недоступна или не существует, либо переданное значение отклонено порталом |\n| 404 | `ENTITY_NOT_FOUND` | Связанная сущность не найдена — например, `responsibleId` указывает на несуществующего сотрудника |\n| 400 | `READONLY_FIELD` | Попытка обновить поле, доступное только на чтение (`id`, `dateStart`, `createdDate`, `changedDate`, `closedDate`, `activityDate`), или `createdBy` (задаётся только при создании) |\n| 403 | `SCOPE_DENIED` | API-ключ не имеет скоупа `tasks` |\n| 401 | `TOKEN_MISSING` | API-ключ не имеет настроенных токенов |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Известные особенности\n\n**Закрытие задачи.** Чтобы пометить задачу выполненной, отправьте `status: 5`. После этого автоматически заполняется `closedDate` — это поле read-only и обновляется только при переводе в статус `5` (завершена) или `6` (отложена).\n\n## Смотрите также\n\n- [Получить задачу](.\u002Fget.md) — текущее состояние перед изменением\n- [Поля задачи](.\u002Ffields.md) — какие поля можно изменять, какие — read-only\n- [Удалить задачу](.\u002Fdelete.md) — полное удаление\n- [Список задач](.\u002Flist.md) — найти задачу перед изменением\n- [Batch-запросы](\u002Fdocs\u002Fbatch) — массовое обновление\n- [Лимиты и оптимизация](\u002Fdocs\u002Foptimization) — rate limits\n","2026-07-01",{}]