Create a custom Role
Requires ac:create; granting organization:delete also requires organization:delete. Built-in names are reserved, names are unique within the organization (409), and every resource a Grant selects must belong to the organization (400).
/organizations/{organizationId}/rolesAuthorizationBearer token (JWT) · headerrequiredAn access token issued by this service (RFC 9068), in the Authorization header as Bearer <token>.
organizationIdstring<uuid>requiredapplication/jsonnamestringrequiredTrimmed and lower-cased; 1 to 64 characters, not a built-in name.
grantsgrant_documentrequiredA Role's Grants as scoped statements. Statements add together. Responses are canonical, one statement per scope instance.
Show propertiesHide properties
versionintegerrequired1statementsgrant_statement[]requiredShow propertiesHide properties
grant_statementscopegrant_scoperequiredThe organization, every instance of a project, cluster or integration type (all), or selected instances (ids).
Show propertiesHide properties
typescope_typerequiredorganizationprojectenvironmentclusterintegrationidsstring<uuid>[]allbooleanpermissionsstring[]requiredPermissions compatible with the scope, as resource:action.
The created Role.
idstring<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
versionintegerrequired1statementsgrant_statement[]requiredShow propertiesHide properties
grant_statementscopegrant_scoperequiredThe organization, every instance of a project, cluster or integration type (all), or selected instances (ids).
Show propertiesHide properties
typescope_typerequiredorganizationprojectenvironmentclusterintegrationidsstring<uuid>[]allbooleanpermissionsstring[]requiredPermissions compatible with the scope, as resource:action.
created_atstring<date-time>requiredThe request failed.
errorstringrequiredStable machine-readable code.
invalid_requestunauthorizedforbiddennot_foundconflictgoneunavailableinternalmessagestringrequiredHuman-readable explanation.