Skip to main content

Roles

Roles are a way to group users together. They can be used to grant permissions to a group of users, or to identify a group of users for other purposes, such as identifying staff members or those who have signed an NDA.

List roles​

Returns all role objects.

Authentication

Service Integration with user:read scope.

Response

link
dataArray of Role (optional)
nullable
The roles that match the search.
Show child attributes
link
idstring
The unique identifier of the role.
link
namestring
The unique name of the role.
link
nextPagestring (optional)
nullable
A cursor for pagination across multiple pages of results. If this attribute is present, there are more results available. Use this value in the nextPage parameter for the next request.
GET /api/v0/rolescURL
curl https://reg.cces.dev/api/v0/roles \
  -H "Authorization: Bearer <token>"
Responseapplication/json
{
  "data": [
    {
      "id": "1234",
      "name": "staff"
    },
  ],
  "nextPage": null
}