For AI agents: markdown of this page — /docs-content-en/automation/bizproc-tasks/complete.md documentation index — /llms.txt

Complete a task

POST /v1/bizproc-tasks/:id/complete

This performs a real approval. approve, reject, ok, cancel are sent as 1, 2, 3, 4. Bitrix24 checks which decisions the task type allows. Re-read the list after a timeout: a retry may encounter an already completed task.

Bitrix24 API: bizproc.task.complete Scope: bizproc

Parameters

Field	Type	Required	Description
`id`	integer	Yes	Positive task ID from list
`status`	string	Yes	approve / reject / ok / cancel
`comment`	string	No	Decision comment; required when the task form requires it
`fields`	object	No	Values keyed by task field code from parameters.Fields[].Id. File values use [filename, base64]. Default request body limit: 1 MiB

Response fields

Field	Type	Description
`success`	boolean	true
`data`	boolean	true, only when Bitrix24 returned true

Examples

cURL API key

Terminal

curl -X POST "https://vibecode.bitrix24.com/v1/bizproc-tasks/42/complete" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status":"approve","comment":"VIBE-PROBE"}'

cURL OAuth

Terminal

curl -X POST "https://vibecode.bitrix24.com/v1/bizproc-tasks/42/complete" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer YOUR_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"status":"approve","comment":"VIBE-PROBE"}'

JavaScript API key

javascript

const response = await fetch("https://vibecode.bitrix24.com/v1/bizproc-tasks/42/complete", {
  method: "POST",
  headers: { "X-Api-Key": "YOUR_API_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({"status":"approve","comment":"VIBE-PROBE"})
});
console.log(await response.json());

JavaScript OAuth

javascript

const response = await fetch("https://vibecode.bitrix24.com/v1/bizproc-tasks/42/complete", {
  method: "POST",
  headers: { "X-Api-Key": "YOUR_APP_KEY", "Authorization": "Bearer YOUR_SESSION_TOKEN", "Content-Type": "application/json" },
  body: JSON.stringify({"status":"approve","comment":"VIBE-PROBE"})
});
console.log(await response.json());

Response example

Response shape from a behavior test. No live approval was performed.

JSON

{"success":true,"data":true}

Invalid parameters are refused before calling Bitrix24: