Permissions

Create team role

Changed on

Creates a team-scoped permission role.

post/teams/{key}/roles

Request

  • Base URL: https://api.session.services
  • URL: https://api.session.services/teams/{key}/roles
  • Auth: API key in header x-tenant-id

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"
    ]
  }
}

Changes