لوكلاء AI: ملف markdown لهذه الصفحة — /docs-content-en/automation/bizproc-tasks.md فهرس التوثيق — /llms.txt

مقالات التوثيق متاحة حاليًا باللغة الإنجليزية فقط.

Business-process tasks

List approval tasks, complete your task or delegate it to a substitute. Completing a task performs a real approval. Show the person the selected task and decision before acting.

Bitrix24 API: bizproc.task.list, bizproc.task.complete, bizproc.task.delegate Scope: bizproc

List tasks

GET /v1/bizproc-tasks

Returns one Bitrix24 page of tasks. By default, a regular user sees their own tasks. An administrator without a filter may see every user's tasks: supply filter={"userId":1373} to select your own. Bitrix24 checks manager and administrator rights.

Bitrix24 API: bizproc.task.list Scope: bizproc

Parameters

Parameter Type Required Description
Parameterselect (query) Typestring Requiredno DescriptionComma-separated fields: camelCase or Bitrix24 names. Defaults to ID, WORKFLOW_ID, DOCUMENT_NAME, NAME
Parameterfilter (query) Typestring Requiredno DescriptionJSON object. Prefixes =, !, !=, <, <=, >, >=. Values are scalars or non-empty arrays of scalars. Fields are those from Response fields, except documentUrl
Parameterorder (query) Typestring Requiredno DescriptionJSON object: a field name and ASC or DESC. Defaults to ID DESC
Parameterstart (query) Typeinteger Requiredno DescriptionNon-negative Bitrix24 page offset, default 0. The next offset is in meta.next

Examples

curl — personal key

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

curl — OAuth application

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

JavaScript — personal key

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

JavaScript — OAuth application

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

Response fields

Field Type Description
Fieldsuccess Typeboolean Descriptiontrue
Fielddata Typeobject[] DescriptionTasks. Field names in camelCase, Bitrix24 value types preserved
Fieldmeta.start Typeinteger DescriptionRequested page offset
Fieldmeta.total Typeinteger DescriptionCount from the Bitrix24 response. Omitted if not returned
Fieldmeta.next Typeinteger DescriptionNext offset from Bitrix24. Omitted on the last page

Available fields: id, activity, activityName, workflowId, documentName, description, name, modified, workflowStarted, workflowStartedBy, overdueDate, workflowTemplateId, workflowTemplateName, workflowState, status, userId, userStatus, moduleId, entity, documentId, parameters, documentUrl. parameters describes the task form. Field-code values are preserved. Secret-bearing URLs are replaced with [REDACTED].

Response example

Empty list on the test account.

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

Error response example

400 — an unknown field is passed in select:

JSON 
{"success":false,"error":{"code":"INVALID_PARAMS","message":"Unknown select field"}}

Errors

HTTP Code Description
HTTP400 CodeINVALID_PARAMS DescriptionUnknown query parameter or field, a parameter passed twice, filter or order is not a JSON object, an invalid prefix or value
HTTP401 CodeTOKEN_MISSING DescriptionNo Bitrix24 credentials
HTTP403 CodeSCOPE_DENIED DescriptionMissing bizproc scope
HTTP403 CodeBITRIX_ACCESS_DENIED DescriptionBitrix24 denies access
HTTP422 CodeBITRIX_ERROR DescriptionBitrix24 business refusal. The message is preserved with secrets removed
HTTP502 CodeBITRIX_RESPONSE_INVALID DescriptionUnexpected response shape or action result

Common refusals and limits: API errors.

See also