Skip to main content

updateTeamRole

Update a team role's name, rank, and/or permission keys (system roles cannot be renamed/re-ranked). When permissions are supplied they REPLACE the role's existing keys. Requires the 'manage_roles' team permission (app admins bypass).

updateTeamRole(
  input: UpdateGroupRoleInput!
): GroupRole!

Arguments​

updateTeamRole.input ● UpdateGroupRoleInput! non-null input​

The role id plus the fields to change (omitted fields are left as-is).

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.