Skip to main content

createTeamRole

Create a custom (non-system) team role granting the given team permission keys. Requires the 'manage_roles' team permission (app admins bypass). Permission keys must be valid team permission keys (group_permission_defs).

createTeamRole(
  input: CreateGroupRoleInput!
): GroupRole!

Arguments​

createTeamRole.input ● CreateGroupRoleInput! non-null input​

The team, the role name, the team permission keys to grant, and an optional rank.

Type​

GroupRole object​

A role within a group (team/channel). Carries the group-management permission keys it grants (e.g. manage_members), NOT world/runtime grid permissions.