Skip to main content

createChannelRole

Create a custom (non-system) channel role granting the given channel permission keys (e.g. send_messages for posting rights). Requires the 'manage_roles' channel permission (app admins bypass).

createChannelRole(
  input: CreateGroupRoleInput!
): GroupRole!

Arguments​

createChannelRole.input ● CreateGroupRoleInput! non-null input​

The channel, the role name, the channel 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.