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