Retrieves a paginated list of user roles for the tenant, optionally filtered by brand name. Use the continuationToken from the previous response to retrieve the next page.
Security
The requesting user must have the following permission to retrieve user roles:
- Administration → Users → View User Roles & Permissions
Identifies the R365 tenant the request applies to. Required on every request.
Maximum number of top-level objects to return in one page.
Brands to filter by (comma-separated)
Pagination token from a previous response. Omit to start from the first page
User Roles
Unique identifier of the user role.
Display name of the user role.
URL to retrieve the next page of results, or null when this is the last page.
Bad Request — a parameter value is malformed, of the wrong type, or outside its allowed range.
Unauthorized — the bearer token is missing, invalid or expired, or is not valid for the specified tenant.
Forbidden — the caller lacks the permission required for this operation.
Not Found — the requested resource does not exist, or the supplied continuation token is unknown or has expired.
Conflict — the request conflicts with the current state of the resource and cannot be applied.
Unprocessable Entity — a required parameter is missing, or a supplied parameter value is invalid.
Too Many Requests — the caller has exceeded the rate limit; retry after a short delay.
Internal Server Error — an unexpected error occurred while processing the request.