For AI agents: markdown of this page — /docs-content-en/entities/tasks/add-accomplices.md documentation index — /llms.txt

Add task accomplices

POST /v1/tasks/:taskId/add-accomplices

Runs tasks.task.addAccomplices once. Requires the task scope (or tasks alias), a write-enabled key, and the Bitrix24 user's permission for the action.

Parameters

Parameter	In	Type	Required	Description
`taskId`	path	integer	yes	Positive task ID from task list.
`accomplicesIds`	body	integer[]	no	Positive IDs from users. If omitted or empty, Bitrix24 returns the current task without adding users.

Examples

curl — personal key

Terminal

curl -X POST 'https://vibecode.bitrix24.com/v1/tasks/289/add-accomplices' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"accomplicesIds":[42]}'

curl — OAuth application

Terminal

curl -X POST 'https://vibecode.bitrix24.com/v1/tasks/289/add-accomplices' \
  -H 'X-Api-Key: YOUR_APP_KEY' \
  -H 'Authorization: Bearer USER_SESSION_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"accomplicesIds":[42]}'

JavaScript — personal key

javascript

const response = await fetch('https://vibecode.bitrix24.com/v1/tasks/289/add-accomplices', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({"accomplicesIds":[42]}),
})
const result = await response.json()
console.log(result.data)

JavaScript — OAuth application

javascript

const response = await fetch('https://vibecode.bitrix24.com/v1/tasks/289/add-accomplices', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({"accomplicesIds":[42]}),
})
const result = await response.json()
console.log(result.data)

Response

Field	Type	Description
`success`	boolean	`true` on success.
`data`	any	Unmodified Bitrix24 method result: a task object, `null`, or another method-specific value.

The example below shows one possible response form; it does not guarantee null.

JSON

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

Error response example

An invalid task ID in the path returns 400: