SetParticipants

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

Updates CRM deal participants. Use this workflow method to replace or extend the staff participant list for an open CRM deal and keep the linked chat participants in sync. The method validates the deal, participant-management permission, pipeline access and open deal status, normalizes participant_user_ids, keeps the responsible user in the participant context, updates deal participants, synchronizes chat staff participants, writes a chat system message and action log, sends DealParticipantsSet webhook and participant notifications and returns row_affected with the deal id. The request body is required and id must be positive; replace_mode true replaces the participant list, while false adds the provided users to the existing list. The caller must have CRM deal participants-manage permission; missing body, invalid id, missing deal, denied access, pipeline ACL failures, closed deal status, database errors, transaction failures and action-log errors are returned as HTTP 200 ErrorResult business errors.

Request Parameters

Request Example

{
  "id": 230,
  "participant_user_ids": [
    18,
    31
  ],
  "replace_mode": true
}

Response Parameters

Response Example

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