Skip to main content
GET
List IDP Group Users
This endpoint lists users who have at least one enterprise role inherited through IDP group membership. These users may also have direct role assignments, so a user can appear both here and in the List users endpoint. Each returned user includes only their IDP-derived role assignments (idp_role_assignments). To see both direct and IDP-derived role assignments for a user, use the Get user endpoint.

Permissions

Requires a service user or personal access token with the ViewAccountMembership permission at the enterprise level.

Authorizations

Authorization
string
header
required

Service User credential (prefix: cog_)

Query Parameters

after
string | null
first
integer
default:100
Required range: 1 <= x <= 200
email
string | null

Filter by exact email address

Response

Successful Response

items
IdpGroupUser · object[]
required
end_cursor
string | null

Cursor to fetch the next page, or None if this is the last page.

has_next_page
boolean
default:false

Whether there are more items available after this page.

total
integer | null

Optional total count (can be omitted for performance).