Skip to main content
GET
List the users holding a role
πŸ”’ Admin only. Requires administrator privileges β€” the authenticated principal (API key, embed JWT, or any bearer token) must belong to a user with the admin role. Lists every user holding the role, directly or through a group, newest first, cursor-paginated via first/after. Accepts built-in role ids. Each user carries every role they hold, so a combination such as β€œholds Explorer but not my custom role” is one pass over these pages. Deactivated users are included. An API key scoped to specific deployments answers 403 here.

Authorizations

Authorization
string
header
required

Token authentication. Send Authorization: Bearer <YOUR_TOKEN>.

Path Parameters

roleId
number
required

Query Parameters

after
string | null
first
integer | null
Required range: x >= 1

Response

items
object[]
required
pageInfo
object
required