Sign in
Organization
Role

Create a new role in the organization

Create a new role and assign it to the organization.

post/v1/organizations/{organizationRef}/roles

Request body

keystring

Stable role template key.

namestring required

Name of the role.

descriptionstring

Description of the role.

actionsAction[]

Actions bundled by this role.

Example request

{
  "key": "org-member",
  "name": "Contributors",
  "description": "Users who can collaborate on the project."
}

Response

Example response

idstring required

ID of the newly created resource.

Changes

No recorded changes to this endpoint across all 24 revisions of this API.