Sign in

v1

latestOpenAPI 3.1.02026-07-24261240.7 KB
Roles

Create Role

Adds a new role to the project.

Security: Requires Platform Admin or Project Admin with Manage Members privilege.

post/access/api/v1/projects/{projectKey}/roles

Path parameters

projectKeystring required

The project key

Request body

namestring required

Role name

descriptionstring

Role description

typestring required

Role type

environmentsstring[]
actionsstring[]

Response

Role created

namestring

Role name

descriptionstring

Role description

type'PREDEFINED' | 'CUSTOM' | 'CUSTOM_GLOBAL'

Role type. PREDEFINED = built-in role, CUSTOM = project-scoped custom role, CUSTOM_GLOBAL = global custom role.

environmentsstring[]

Environments for the role

actionsstring[]

Actions permitted by this role