Skip to main content

updateChannelRole

Update a channel 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' channel permission (app admins bypass). Note: changing send_messages here does not re-push Buddy until affected members' roles are re-applied via setChannelMemberRoles.

updateChannelRole(
  input: UpdateGroupRoleInput!
): GroupRole!

Arguments​

updateChannelRole.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.