SetResponsible

[POST] .../v1/lead/setresponsible

Assigns the responsible user for a CRM lead. Use this workflow method instead of Lead/Edit when changing the user responsible for a CRM lead. The method validates the lead, responsible user and pipeline access, preserves the previous responsible user as a participant when needed, updates the assignment, synchronizes chat staff participants, writes a chat system message, sends LeadResponsibleSet webhook and assignment notifications and returns row_affected with the lead id. The request body is required; id and responsible_user_id must both be positive and responsible_user_id must resolve to an existing active user. The caller must have CRM lead responsible-set permission; missing body, invalid ids, missing lead, missing responsible user, denied access, pipeline ACL failures, storage errors are returned as HTTP 200 ErrorResult.

Request Parameters

Request Example

{
  "id": 105,
  "responsible_user_id": 31
}

Response Parameters

Response Example

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