[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-task-stages":3,"docs-tabs-task-stages":6},{"content":4,"lastmod":5},"# Стадии канбана задач\n\n`GET \u002Fv1\u002Ftasks\u002Fstages\u002F:entityId`\n\nВозвращает текущие колонки канбана рабочей группы или личного плана «Мои задачи» текущего пользователя. Применяется, чтобы показать набор стадий доски и их порядок.\n\nБитрикс24 API: `task.stages.get`\nСкоуп: `task`\n\n## Параметры\n\n| Параметр | Тип | Обяз. | По умолч. | Описание |\n|----------|-----|:-----:|-----------|----------|\n| `entityId` (path) | number | да | — | Владелец стадий: идентификатор рабочей группы или `0` — личный план «Мои задачи» текущего пользователя. Источник группы: `GET \u002Fv1\u002Fworkgroups` |\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Ftasks\u002Fstages\u002F7\" \\\n  -H \"X-Api-Key: YOUR_API_KEY\"\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Ftasks\u002Fstages\u002F7\" \\\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\u002Fstages\u002F7', {\n  headers: { 'X-Api-Key': 'YOUR_API_KEY' },\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\u002Fstages\u002F7', {\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` | array | Массив колонок, отсортированный по `sort` |\n| `data[].id` | number | Идентификатор стадии |\n| `data[].title` | string | Название колонки |\n| `data[].sort` | number | Порядок сортировки на доске |\n| `data[].color` | string | Цвет колонки в формате `RRGGBB` |\n| `data[].systemType` | string | Тип системной стадии: `NEW`, `WORK`, `REVIEW`, `FINISH`. Для пользовательских колонок — `null` |\n| `data[].entityId` | number | Идентификатор владельца — группы или пользователя |\n| `data[].entityType` | string | Тип владельца: `G` — группа, `U` — личный план |\n\n## Пример ответа\n\nСтадии канбана группы 7:\n\n```json\n{\n  \"success\": true,\n  \"data\": [\n    {\n      \"id\": 87,\n      \"title\": \"Новые\",\n      \"sort\": 100,\n      \"color\": \"00C4FB\",\n      \"systemType\": \"NEW\",\n      \"entityId\": 7,\n      \"entityType\": \"G\"\n    },\n    {\n      \"id\": 88,\n      \"title\": \"Выполняются\",\n      \"sort\": 200,\n      \"color\": \"47D1E2\",\n      \"systemType\": null,\n      \"entityId\": 7,\n      \"entityType\": \"G\"\n    },\n    {\n      \"id\": 89,\n      \"title\": \"Сделаны\",\n      \"sort\": 300,\n      \"color\": \"75D900\",\n      \"systemType\": null,\n      \"entityId\": 7,\n      \"entityType\": \"G\"\n    }\n  ]\n}\n```\n\n## Пример ответа при ошибке\n\n400 — `entityId` меньше нуля:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"INVALID_PARAMS\",\n    \"message\": \"entityId must be a non-negative integer (0 = personal plan)\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | Код | Описание |\n|------|-----|----------|\n| 400 | `INVALID_PARAMS` | `entityId` меньше нуля или не число |\n| 403 | `BITRIX_ACCESS_DENIED` | Нет доступа к задачам этой группы или группы с таким `entityId` не существует |\n| 403 | `SCOPE_DENIED` | Ключу не хватает скоупа `task` |\n| 401 | `TOKEN_MISSING` | У ключа не настроены токены доступа |\n| 401 | `MISSING_API_KEY` | Не передан заголовок `X-Api-Key` |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Известные особенности\n\n**Колонки группы и история задачи не совпадают.** Метод возвращает текущие колонки группового канбана. В истории задачи событие `STAGE` хранит название стадии на момент перехода — оно может отличаться от текущих колонок группы, а стадии спринта в групповой канбан не входят. Для разбора прошлых переходов опирайтесь на значение из истории, а не на этот справочник.\n\n## Смотрите также\n\n- [История изменений задачи](\u002Fdocs\u002Ftask-history)\n- [Задачи](\u002Fdocs\u002Fentities\u002Ftasks)\n- [Справочник сущностей](\u002Fdocs\u002Fentity-api)\n- [Ошибки](\u002Fdocs\u002Ferrors)\n","2026-07-15",{}]