25.03.2026 15:10

SetParticipants

[POST] .../v1/deal/setparticipants

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

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

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

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

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

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

{
  "id": 220,
  "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": [220]
  }
}