Skip to main content
GET
List

Authorizations

Authorization
string
header
required

OAuth 2.0 client-credentials flow. Request an access token from the token endpoint and send it as Authorization: Bearer <token>.

Query Parameters

pageSize
integer<int32>
default:50

Maximum items per page.

Required range: 1 <= x <= 200
pageToken
string

Opaque page token from the previous response's nextPageToken. Omit it for the first page; pass it back exactly as received. Do not parse or construct it.

applicationInstanceId
string<uuid>

Scope the list to a single application instance, identified by its id (UUID). An application instance is one connected integration in your tenant: a specific Okta, Workday, and so on. Omit it to list across all of your instances.

Response

A page of roles.

items
object[]
required
nextPageToken
string

Opaque token for the next page; pass it back as pageToken. Present whenever more pages remain, including when this page is empty because the results are still being prepared, and absent only once the collection is fully returned. Do not parse or construct it.