[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
]
}
}