latestOpenAPI 3.1.02026-07-24239123562.1 KB

0205e2bace53

Roles

Create a new role in an organization

post/v1/roles

Request body

namestring
descriptionstring
ssoGroupMappingsstring[]
enabledboolean
policyScopesstring[]

Example request

{
  "ssoGroupMappings": [
    "idp-group-name"
  ],
  "policyScopes": [
    "developer"
  ]
}

Response

Responding with created role

idId — unresolved $ref
namestring
descriptionstring
organizationIdId — unresolved $ref
ssoGroupMappingsstring[]
enabledboolean
createdAtCreatedAt — unresolved $ref
policyScopesstring[]