[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-entities\u002Ftasks\u002Fget":3,"docs-tabs-entities\u002Ftasks\u002Fget":6},{"content":4,"lastmod":5},"\n## Получить задачу\n\n`GET \u002Fv1\u002Ftasks\u002F:id`\n\nВозвращает одну задачу со всеми полями. Дополнительно к полям списка приходят встроенные объекты постановщика и ответственного, чек-лист, разрешённые действия и расширенная информация о соисполнителях и наблюдателях.\n\n## Параметры\n\n| Параметр | Тип | Обяз. | Описание |\n|----------|-----|:-----:|---------|\n| `id` (path) | number | да | ID задачи |\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Ftasks\u002F289\" \\\n  -H \"X-Api-Key: YOUR_API_KEY\"\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Ftasks\u002F289\" \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\"\n```\n\n### JavaScript — личный ключ\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Ftasks\u002F289', {\n  headers: {\n    'X-Api-Key': 'YOUR_API_KEY',\n  },\n})\n\nconst { success, data } = await res.json()\nconsole.log(data.title, '— статус:', data.status)\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Ftasks\u002F289', {\n  headers: {\n    'X-Api-Key': 'YOUR_APP_KEY',\n    'Authorization': 'Bearer USER_SESSION_TOKEN',\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| Поле | Тип | Описание |\n|------|-----|---------|\n| `data.creator` | object | Постановщик: `{ id, name, link, icon, workPosition }` |\n| `data.responsible` | object | Ответственный: тот же формат, что и `creator` |\n| `data.accomplicesData` | object[] | Подробности по соисполнителям (тот же формат, что и `creator`) |\n| `data.auditorsData` | object[] | Подробности по наблюдателям (тот же формат, что и `creator`) |\n| `data.action` | object | Карта разрешённых действий (boolean): `complete`, `start`, `pause`, `delegate`, `remove`, `edit`, `defer`, `changeDeadline`, `checklistAddItems` и другие |\n| `data.checklist` | array | Пункты чек-листа (пустой массив, если чек-лист не заполнен) |\n| `data.checkListTree` | object | Дерево чек-листа с метаданными |\n| `data.newCommentsCount` | number | Количество непрочитанных комментариев |\n\n## Пример ответа\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"id\": \"289\",\n    \"title\": \"Подготовить отчёт за квартал\",\n    \"description\": \"\",\n    \"status\": \"2\",\n    \"priority\": \"1\",\n    \"groupId\": \"0\",\n    \"responsibleId\": \"79\",\n    \"createdBy\": \"99\",\n    \"createdDate\": \"2026-05-12T09:11:18+03:00\",\n    \"changedDate\": \"2026-05-12T09:11:18+03:00\",\n    \"deadline\": \"2026-05-19T18:00:00+03:00\",\n    \"accomplices\": [],\n    \"auditors\": [],\n    \"checklist\": [],\n    \"creator\": {\n      \"id\": \"99\",\n      \"name\": \"Анна Соколова\",\n      \"link\": \"\u002Fcompany\u002Fpersonal\u002Fuser\u002F99\u002F\",\n      \"icon\": \"https:\u002F\u002Fexample.bitrix24.ru\u002F...\u002Favatar.png\",\n      \"workPosition\": null\n    },\n    \"responsible\": {\n      \"id\": \"79\",\n      \"name\": \"Дмитрий Орлов\",\n      \"link\": \"\u002Fcompany\u002Fpersonal\u002Fuser\u002F79\u002F\",\n      \"icon\": \"\u002Fbitrix\u002Fimages\u002Ftasks\u002Fdefault_avatar.png\",\n      \"workPosition\": null\n    },\n    \"newCommentsCount\": 0,\n    \"action\": {\n      \"complete\": true,\n      \"start\": true,\n      \"delegate\": true,\n      \"edit\": true,\n      \"remove\": true,\n      \"defer\": true,\n      \"changeDeadline\": true\n    }\n  }\n}\n```\n\n## Пример ответа при ошибке\n\n404 — задача не найдена:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"ENTITY_NOT_FOUND\",\n    \"message\": \"task 999999999 not found\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | Код | Описание |\n|------|-----|---------|\n| 404 | `ENTITY_NOT_FOUND` | Задача с таким ID не найдена |\n| 403 | `SCOPE_DENIED` | API-ключ не имеет скоупа `tasks` |\n| 401 | `TOKEN_MISSING` | API-ключ не имеет настроенных токенов |\n| 401 | `MISSING_API_KEY` | Не передан заголовок `X-Api-Key` |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Известные особенности\n\n**Встроенные данные пользователей.** Поля `creator` и `responsible` приходят вложенным объектом с именем, ссылкой на профиль и аватаркой. Отдельный `GET \u002Fv1\u002Fusers\u002F:id` для отображения автора задачи не требуется.\n\n**Числовые значения как строки.** Большинство числовых полей (`id`, `status`, `priority`, `responsibleId`, `createdBy`, `groupId` и подобные) приходят строками. Для арифметики и сравнений приводите через `Number(value)`. Исключения: `newCommentsCount` приходит **числом** (и в списке, и в карточке); `commentsCount`\u002F`serviceCommentsCount` приходят либо `null`, либо строкой (`\"0\"`\u002F`\"N\"`) — числом не бывают. `chatId` непоследователен: в списке строка (`\"255\"`), в карточке число (`255`) — приводите через `Number()`.\n\n## Смотрите также\n\n- [Список задач](.\u002Flist.md) — поиск задачи перед чтением\n- [Поля задачи](.\u002Ffields.md) — полный список полей и расшифровка значений `status`\u002F`priority`\n- [Обновить задачу](.\u002Fupdate.md) — изменить состояние или сроки\n- [Удалить задачу](.\u002Fdelete.md) — снять задачу\n- [Комментарии задачи](\u002Fdocs\u002Fentities\u002Ftask-comments) — обсуждение\n- [Учёт времени](.\u002Ftime.md) — записи о трудозатратах\n- [Чек-лист задачи](.\u002Fchecklist.md) — пункты чек-листа (add\u002Fupdate\u002Fcomplete)\n- [Лимиты и оптимизация](\u002Fdocs\u002Foptimization) — rate limits\n","2026-06-19",{}]