[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-automation\u002Fworkflows\u002Flist":3,"docs-tabs-automation\u002Fworkflows\u002Flist":6},{"content":4,"lastmod":5},"\n## Список запущенных бизнес-процессов\n\n`GET \u002Fv1\u002Fworkflows`\n\nВозвращает запущенные экземпляры бизнес-процессов на портале, отсортированные по дате изменения (сначала новые).\n\n## Параметры\n\n| Параметр | Тип | Описание |\n|----------|-----|---------|\n| `templateId` | number | Фильтр по ID шаблона бизнес-процесса |\n| `startedBy` | number | Фильтр по ID пользователя, запустившего процесс |\n| `offset` | number | Смещение для пагинации. По умолчанию 0 |\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fworkflows \\\n  -H \"X-Api-Key: YOUR_API_KEY\"\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fworkflows \\\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\u002Fworkflows', {\n  headers: { 'X-Api-Key': 'YOUR_API_KEY' },\n})\nconst { data, meta } = await res.json()\nconsole.log(`Процессов: ${meta.total}`, data)\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fworkflows', {\n  headers: {\n    'X-Api-Key': 'YOUR_APP_KEY',\n    'Authorization': 'Bearer USER_SESSION_TOKEN',\n  },\n})\nconst { data } = await res.json()\n```\n\n## Поля ответа\n\n| Поле | Тип | Описание |\n|------|-----|---------|\n| `success` | boolean | Всегда `true` при успехе |\n| `data` | array | Массив экземпляров бизнес-процессов |\n| `data[].ID` | string | Уникальный идентификатор экземпляра |\n| `data[].MODIFIED` | string | Дата последнего изменения (ISO 8601) |\n| `data[].OWNED_UNTIL` | string \\| null | Дата блокировки на выполнение текущего шага; `null` если не заблокирован |\n| `data[].MODULE_ID` | string | Модуль сущности (например `crm`) |\n| `data[].ENTITY` | string | Класс документа (например `CCrmDocumentDeal`) |\n| `data[].DOCUMENT_ID` | string | Идентификатор документа в формате `TYPENAME_ID` (например `DEAL_5141`) |\n| `data[].STARTED` | string | Дата запуска (ISO 8601) |\n| `data[].STARTED_BY` | string | ID пользователя, запустившего процесс (`\"0\"` — системный запуск) |\n| `data[].TEMPLATE_ID` | string | ID шаблона бизнес-процесса |\n| `meta.total` | number | Общее количество найденных экземпляров |\n\n## Пример ответа\n\n```json\n{\n  \"success\": true,\n  \"data\": [\n    {\n      \"ID\": \"69f0c2d5ade389.22457798\",\n      \"MODIFIED\": \"2026-04-28T17:23:17+03:00\",\n      \"OWNED_UNTIL\": null,\n      \"MODULE_ID\": \"crm\",\n      \"ENTITY\": \"CCrmDocumentDeal\",\n      \"DOCUMENT_ID\": \"DEAL_5141\",\n      \"STARTED\": \"2026-04-28T17:23:17+03:00\",\n      \"STARTED_BY\": \"0\",\n      \"TEMPLATE_ID\": \"713\"\n    }\n  ],\n  \"meta\": {\n    \"total\": 1\n  }\n}\n```\n\n## Пример ответа при ошибке\n\n403 — нет скоупа `bizproc`:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"SCOPE_DENIED\",\n    \"message\": \"This endpoint requires 'bizproc' scope\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | Код | Описание |\n|------|-----|---------|\n| 401 | `MISSING_API_KEY` | Не передан заголовок `X-Api-Key` |\n| 401 | `INVALID_API_KEY` | Неверный или недействительный API-ключ |\n| 401 | `TOKEN_MISSING` | У ключа нет подключённых токенов Битрикс24 |\n| 401 | `TOKEN_EXPIRED` | Пользовательская сессия OAuth истекла — повторите авторизацию через `\u002Fv1\u002Foauth\u002Fauthorize` |\n| 403 | `SCOPE_DENIED` | Ключу не хватает скоупа `bizproc` |\n| 403 | `BITRIX_ACCESS_DENIED` | Битрикс24 отказал в доступе |\n| 429 | `RATE_LIMITED` | Превышен лимит запросов. Повторите через 1–2 секунды |\n| 502 | `BITRIX_UNAVAILABLE` | Битрикс24 недоступен |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Известные особенности\n\n- **`DOCUMENT_ID` — строка, не массив.** Поле возвращается строкой в формате `\"TYPENAME_ID\"` (например `\"DEAL_5141\"`), а не массивом. При запуске процесса через `POST \u002Fv1\u002Fworkflows\u002Fstart` идентификатор документа передаётся в Битрикс24 массивом, однако в ответе этого эндпоинта он нормализован к строке.\n\n## Смотрите также\n\n- [Запустить бизнес-процесс](\u002Fdocs\u002Fautomation\u002Fworkflows\u002Fstart)\n- [Завершить бизнес-процесс](\u002Fdocs\u002Fautomation\u002Fworkflows\u002Fterminate)\n- [Бизнес-процессы](\u002Fdocs\u002Fautomation\u002Fworkflows)\n","2026-06-23",{}]