25.03.2026 15:10

SetParticipants

[POST] .../v1/lead/setparticipants

Обновляет участников CRM-обращения.

Входные параметры

Название Тип данных Обязательность Описание
id Int64 Обязательный ID обращения
participant_user_ids Array of Int64 Необязательный Список участников
replace_mode Boolean Необязательный Режим обновления: true — заменить состав, false — добавить к текущему

Ограничения и проверки

  • Требуется право crm_lead_participant_manage (725).
  • Проверяется доступ к воронке обращения по ACL.
  • Текущий ответственный лида всегда остается в participant_user_ids, даже если не передан в запросе.
  • Если у обращения есть связанный чат, список staff-участников синхронизируется из сущности лида.

Пример запроса

{
  "id": 105,
  "participant_user_ids": [15, 18, 27],
  "replace_mode": true
}

Выходные параметры

Название Тип данных Описание
result.row_affected Int64 Количество измененных строк
result.ids Array of Int64 ID измененных записей

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

{
  "ok": true,
  "result": {
    "row_affected": 1,
    "ids": [105]
  }
}