Associate Permissions to Role
Assign/Un-assign ACF permissions to a role.
URL: /role-updatePermission
Type: PUT
Parameters
| Param Type | Name | Description | Field Type |
|---|---|---|---|
| Header | sessionId ** | Session Id received after login | string |
| Query | Gwkey | Tenant Key. Needed only in case of multitenant installations | string |
| Query | gwsource** | Source from which the request is triggered (for example, web, external) | String |
| Payload | roleName** | Name of the role | String |
| Payload | assignPermissionList | ACF permissions to be assigned to the role. Refer to the list of possible permissions list for details. | Array |
| Payload | unassignPermissionList | ACF permissions to be unassigned from the role. Refer to the list of possible permissions list for details. | Array |
** - Mandatory value
Even if the assignPermissionList and unassignPermissionList contain invalid ACF permission text that cannot be processed, the API would still go-ahead to assign/un-assign any functions in wither list that can be processed.
Possible Response Message and Code
| HTTP Code | Description | Response Message |
|---|---|---|
| 400 | Bad request | Role name cannot be left empty or blank. |
| 202 | Accepted | ACF assignment initiated for the given role. |
| 400 | Bad request | Permission list cannot be empty |