v3

latestOpenAPI 3.0.12026-07-31240345599.7 KB

Team roles

Create team role

Creates a team role

post/api/{cloudId}/v1/teams/{teamId}/roles

Path parameters

teamId'id' | 'name' required

Id of the team.

Request body

namestring

The name of the custom user role.

Example request

{
  "name": "createRole",
  "rights": [
    {
      "right": "access-reports",
      "granted": true
    },
    {
      "right": "delete-escalations",
      "granted": false
    }
  ]
}

Response

Returned if the request is successful.

idstring

The id of the team role.

namestring

The name of the team role.