List Roles
Requires ac:read. The built-in Roles (owner, admin, member) are listed with their fixed Grants.
GET
/organizations/{organizationId}/rolesAuthorization
AuthorizationBearer token (JWT) · headerrequiredAn access token issued by this service (RFC 9068), in the Authorization header as Bearer <token>.
Path parameters
organizationIdstring<uuid>requiredResponses
200
The Roles and their Grants, oldest first.
Array of
roleidstring<uuid>requirednamestringrequiredbuiltinbooleanrequiredBuilt-in Roles (owner, admin, member) cannot be renamed, edited or deleted.
grantsgrant_documentrequiredA Role's Grants as scoped statements. Statements add together. Responses are canonical, one statement per scope instance.
Show propertiesHide properties
versionintegerrequiredAllowed:
1statementsgrant_statement[]requiredmax items 500
Show propertiesHide properties
Array of
grant_statementscopegrant_scoperequiredThe organization, every instance of a project, cluster or integration type (all), or selected instances (ids).
Show propertiesHide properties
typescope_typerequiredAllowed:
organizationprojectenvironmentclusterintegrationidsstring<uuid>[]min items 1 · max items 100
allbooleanpermissionsstring[]requiredPermissions compatible with the scope, as resource:action.
min items 1 · max items 50
created_atstring<date-time>requireddefault
The request failed.
errorstringrequiredStable machine-readable code.
Allowed:
invalid_requestunauthorizedforbiddennot_foundconflictgoneunavailableinternalmessagestringrequiredHuman-readable explanation.