latestOpenAPI 3.0.32026-08-137683171.1 KB
be08f4f706f5
Roles
List roles
Returns roles for the caller's organization. By default only org-scoped roles are returned. Pass include=cluster to also include cluster-wide roles (those with organizationId == null, e.g. super-admin and other system-actor roles); these are not assignable from the org UI but downstream consumers like the auth-context role lookup and the events page need them to resolve cluster-wide role IDs.
get/roles
Query parameters
include'cluster'
Set to cluster to additionally include cluster-wide roles (organizationId == null). Omit for org-scoped roles only.
limitinteger
Page size (default 50, max 200)
cursorstring
Opaque pagination cursor from a previous response
Response
Success