User roles endpoints
By assigning roles to users, you can manage them in sets
that are granted access permissions to various PE objects. This makes tracking user access
more organized and easier to manage. The roles
endpoints enable you to get lists of roles and create new
roles.
-
User role keys
The following keys are used with the RBAC v1 API’s roles endpoints. -
GET /roles
Fetches all roles with user and group ID lists and permission lists. Authentication is required. -
GET /roles/<rid>
Fetches a single role by its ID (rid). Authentication is required. -
POST /roles
Creates a role, and attaches to it the specified permissions and the specified users and groups. Authentication is required. -
PUT /roles/<rid>
Replaces a role at the specified ID (rid) with a new role object. Authentication is required. -
DELETE /roles/<rid>
Deletes the role identified by the role ID (rid). Users with this role immediately lose the role and all permissions granted by it, but their session is otherwise unaffected. Access to the next request that the user makes is determined by the new set of permissions the user has without this role.