For AI agents: markdown of this page — /docs-content-en/entities/call-lists/replace.md documentation index — /llms.txt

Replace participants

PUT /v1/call-lists/:id

Bitrix24 API: crm.calllist.update

Scope: crm

This fully replaces participants: omitted participants are removed. entityType and entities are required as for creation. The type must match the list: a get preflight returns 400 INVALID_PARAMS before update on mismatch. Omitting webformId clears the form. skipped contains IDs absent from visible readback, including retained participants whose read permission was revoked. A readback failure does not undo replacement. A missing list returns 404 ENTITY_NOT_FOUND; missing participants or forms return 422 BITRIX_ERROR.

JSON

{
  "entityType": "CONTACT",
  "entities": [
    37,
    245
  ]
}

JSON

{
  "success": true,
  "data": {
    "id": 10,
    "skipped": [
      245
    ]
  }
}

READONLY keys may read; POST and PUT return 403 WRITE_BLOCKED_READONLY_KEY. Other platform business refusals return 422 BITRIX_ERROR.