List Groups
List the groups synced from your connected integrations. Returns 404 if app_id is not an app in your organization.
Listing groups needs permission to read groups across the organization. Of the built-in roles, Admin, Read Only Admin, AppStore Read Only Admin, and App Admin have it. Anyone else gets 403.
Paginated via opaque cursor: pass the next_page_token value from the previous response back as the page_token query parameter to fetch the next page. When next_page_token is null, the current page is the last one.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Filters groups by integration specific ID, e.g. the group's Okta ID.
Filters groups by name.
Search filter should be an exact match.
Filters groups by the ID of the app to which they belong.
Opaque cursor from a previous response's next_page_token. Omit to fetch the first page. Treat as opaque: do not decode, construct, or interpret it.
Maximum number of items to return per page. Values above 1000 are clamped to 1000 rather than rejected.
x >= 1Response
Successful Response
Groups returned in this page.
Token for the next page, or null when this is the last page. An absent token is the only end-of-results signal. A page holding fewer than page_size items does not mean the results are exhausted. Treat the value as opaque: do not decode, construct, or interpret it.