SetAccess

[POST] .../v1/pipeline/setaccess

Configures ACL access for a CRM pipeline. Use this workflow method after Pipeline/Add or Pipeline/Get to replace or extend the explicit user and group access lists for one pipeline. The method updates access_all, synchronizes ACL rows in replace or append mode, writes pipeline/user/group action log records, invalidates CRM and chat entity-access caches and returns row_affected with the pipeline id. The request body is required and id must be positive; when access_all is false and both ACL arrays are empty the server stores access_all as true. The caller must have CRM pipeline edit permission; missing body, invalid id, denied access, missing pipeline, database failures, transaction failures, cache invalidation errors and action-log errors are returned as HTTP 200 ErrorResult business errors.

Request Parameters

Name Type Required Description
access_all Boolean Optional Grants access to all users.
access_group_ids Array of Int64 Optional User group IDs with access.
access_user_ids Array of Int64 Optional User IDs with access.
id Int64 Required Pipeline ID.
replace_mode Boolean Optional ACL update mode. true replaces the full ACL; false adds entries to the current ACL.

Request Example

{
  "id": 7,
  "access_all": false,
  "access_user_ids": [
    1,
    15
  ],
  "access_group_ids": [
    4
  ],
  "replace_mode": true
}

Response Parameters

Name Type Description
ok Boolean Indicates whether the request completed successfully.
result Update Update operation result.

Response Example

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