Для AI-агентов: markdown этой страницы — /docs-content/automation/bizproc-tasks/list.md индекс документации — /llms.txt

Список заданий

GET /v1/bizproc-tasks

Одна страница заданий Битрикс24. Обычный пользователь по умолчанию видит свои задания. Администратор без фильтра может увидеть задания всех пользователей: для своих укажите filter={"userId":1373}. Права руководителя и администратора проверяет Битрикс24.

Bitrix24 API: bizproc.task.list Скоуп: bizproc

Параметры

Поле	Тип	Обязательно	Описание
`select`	string	Нет	Поля через запятую: camelCase или имена Битрикс24. По умолчанию ID, WORKFLOW_ID, DOCUMENT_NAME, NAME
`filter`	string	Нет	JSON-объект. Префиксы =, !, !=, <, <=, >, >=. Значения — скаляры или непустые массивы скаляров
`order`	string	Нет	JSON-объект: имя поля и ASC или DESC. По умолчанию ID DESC
`start`	integer	Нет	Неотрицательная позиция страницы Битрикс24, по умолчанию 0. Следующая — meta.next

Поля ответа

Поле	Тип	Описание
`success`	boolean	true
`data`	object[]	Задания. Имена полей в camelCase, типы значений Битрикс24 сохранены
`meta.start`	integer	Запрошенная позиция страницы
`meta.total`	integer	Количество из ответа Битрикс24. Отсутствует, если не вернулось
`meta.next`	integer	Следующая позиция из Битрикс24. Отсутствует на последней странице

Доступные поля: id, activity, activityName, workflowId, documentName, description, name, modified, workflowStarted, workflowStartedBy, overdueDate, workflowTemplateId, workflowTemplateName, workflowState, status, userId, userStatus, moduleId, entity, documentId, parameters, documentUrl. parameters описывает форму задания. Значения кодов полей сохранены. URL с секретами заменены на [REDACTED].

Примеры

cURL API key

Terminal

curl -X GET "https://vibecode.bitrix24.tech/v1/bizproc-tasks" \
  -H "X-Api-Key: YOUR_API_KEY"

cURL OAuth

Terminal

curl -X GET "https://vibecode.bitrix24.tech/v1/bizproc-tasks" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer YOUR_SESSION_TOKEN"

JavaScript API key

javascript

const response = await fetch("https://vibecode.bitrix24.tech/v1/bizproc-tasks", {
  method: "GET",
  headers: { "X-Api-Key": "YOUR_API_KEY" }
});
console.log(await response.json());

JavaScript OAuth

javascript

const response = await fetch("https://vibecode.bitrix24.tech/v1/bizproc-tasks", {
  method: "GET",
  headers: { "X-Api-Key": "YOUR_APP_KEY", "Authorization": "Bearer YOUR_SESSION_TOKEN" }
});
console.log(await response.json());

Пример ответа

Пустой список на тестовом аккаунте.

JSON

{"success":true,"data":[],"meta":{"start":0,"total":0}}

Неверные параметры отклоняются до вызова Битрикс24: