v11

latestOpenAPI 3.1.12026-08-03174162.0 MB
Permissions

Create team role

Creates a team-scoped permission role.

post/teams/{key}/roles

Path parameters

keystring required

Team identifier (ID or slug)

Request body

namestring required

Role display name

descriptionstring

Optional role description

permissionsstring[] required

Non-empty array of permission nodes. Supports wildcard and negation.

Example request

{
  "permissions": [
    "team.read",
    "team.member.write"
  ]
}

Response

OK

Example response

{
  "role": {
    "permissions": [
      "team.read",
      "team.member.write"
    ]
  }
}