Permission Resources

LAST EDIT Sep 27 2021

Permissions policies can match one or more resources. Here is the complete list of permissions available. Please keep in mind that this only applies to API calls done by clients, API requests performed from your backend do not need to pass a permission check.

Resource

Internal name

Description

Create Channel

CreateChannel

Creating a new channel

Create Distinct Channel For Others

CreateDistinctChannelForOthers

Allows to create distinct channels (channels created using list of members) for other users (e.g. user A creates channel for users B and C)

Read Channel

ReadChannel

Reading messages and receive new messages on a channel

Update Channel Members

UpdateChannelMembers

Adding or removing members to a channel

Remove Own Channel Membership

RemoveOwnChannelMembership

Removing own channel membership (leave the channel)

Update Channel

UpdateChannel

Updating the channel data

Use Frozen Channel

UseFrozenChannel

Create messages and reactions as if the channel wasn't frozen

Update User Role

UpdateUserRole

Updating the role of the user

Delete Channel

DeleteChannel

Deleting a channel

Create Message

CreateMessage

Send a new message

Update Message

UpdateMessage

Update an existing message

Pin Message

PinMessage

Pinning a message

Delete Message

DeleteMessage

Deleting a message

Run Message Action

RunMessageAction

Run an action over a message

Mute User

MuteUser

Mute another user

Ban User

BanUser

Ban a user

Upload Attachment

UploadAttachment

Upload an attachment (file/image)

Delete Attachment

DeleteAttachment

Delete an attachment (file/image)

Add Links

AddLinks

Include URLs to messages

Create Reaction

CreateReaction

Add a reaction to a message

Delete Reaction

DeleteReaction

Remove a reaction

Send Custom Event

SendCustomEvent

Send a custom event on a channel

Skip Message Moderation

SkipMessageModeration

Skipping message moderation

Read Message Flags

ReadMessageFlags

View messages which have been flagged by users

Update Channel Frozen

UpdateChannelFrozen

Allows user to update channel.frozen field

Update Channel Cooldown

UpdateChannelCooldown

Allows user to update channel.cooldown field

Skip Channel Cooldown

SkipChannelCooldown

Allows user to skip channel cooldowm

Default Permissions

Copied!

The five built-in channel types ship with default permission setting.

Messaging

Copied!

Admin

Moderator

User

Guest

Anonymous

Channel Member

Owner

Create Channel

Yes

Yes

Yes

No

No

Yes

No

Create Distinct Channel For Others

Yes

Yes

Yes

No

No

Yes

No

Delete Channel

Yes

No

No

No

No

No

Yes

Read Channel

Yes

Yes

No

No

No

Yes

Yes

Update Channel Members

Yes

Yes

No

No

No

No

Yes

Remove Own Channel Membership

Yes

Yes

No

No

No

Yes

No

Update Channel Roles

No

No

No

No

No

No

No

Update Channel

Yes

Yes

No

No

No

No

Yes

Use Frozen Channel

Yes

Yes

No

No

No

No

No

Create Message

Yes

Yes

No

No

No

Yes

No

Add Links

Yes

Yes

No

No

No

Yes

No

Update Message

Yes

Yes

No

No

No

No

Yes

Pin Message

Yes

Yes

No

No

No

Yes

No

Delete Message

Yes

Yes

No

No

No

No

Yes

Create Reaction

Yes

Yes

No

No

No

Yes

No

Delete Reaction

Yes

No

No

No

No

No

Yes

Ban User

Yes

Yes

No

No

No

No

No

Edit User Role

No

No

No

No

No

No

No

Upload Attachment

Yes

Yes

No

No

No

Yes

No

Delete Attachment

Yes

Yes

No

No

No

No

Yes

Use Commands

Yes

Yes

No

No

No

Yes

No

Send Custom event

Yes

Yes

No

No

No

Yes

No

Read Message Flags

No

Yes

No

No

No

No

No

Skip Message Moderation

Yes

Yes

No

No

No

No

No

Use Cooldown Channel

Yes

Yes

No

No

No

No

No

Skip Channel Cooldown

Yes

Yes

No

No

No

No

No

Livestream

Copied!

Admin

Moderator

User

Guest

Anonymous

Channel Member

Owner

Create Channel

Yes

Yes

Yes

No

No

Yes

No

Create Distinct Channel For Others

Yes

Yes

Yes

No

No

Yes

No

Delete Channel

Yes

No

No

No

No

No

No

Read Channel

Yes

Yes

Yes

Yes

Yes

Yes

Yes

Update Channel Members

Yes

No

No

No

No

No

No

Remove Own Channel Membership

Yes

Yes

Yes

No

No

Yes

No

Update Channel Roles

No

No

No

No

No

No

No

Update Channel

Yes

No

No

No

No

No

No

Use Frozen Channel

Yes

Yes

No

No

No

No

No

Create Message

Yes

Yes

Yes

No

No

Yes

No

Add Links

Yes

Yes

Yes

No

No

Yes

No

Update Message

Yes

Yes

No

No

No

No

Yes

Pin Message

Yes

Yes

No

No

No

No

Yes

Delete Message

Yes

Yes

No

No

No

No

Yes

Create Reaction

Yes

Yes

Yes

No

No

Yes

No

Delete Reaction

Yes

No

No

No

No

No

Yes

Ban User

Yes

Yes

No

No

No

No

No

Edit User Role

No

No

No

No

No

No

No

Upload Attachment

Yes

Yes

Yes

No

No

Yes

No

Delete Attachment

Yes

Yes

No

No

No

No

Yes

Use Commands

Yes

Yes

Yes

No

No

Yes

No

Send Custom event

Yes

Yes

Yes

No

No

Yes

No

Read Message Flags

No

Yes

No

No

No

No

No

Skip Message Moderation

Yes

Yes

No

No

No

No

No

Use Cooldown Channel

Yes

Yes

No

No

No

No

No

Skip Channel Cooldown

Yes

Yes

No

No

No

No

No

Gaming

Copied!

Admin

Moderator

User

Guest

Anonymous

Channel Member

Owner

Create Channel

Yes

No

No

No

No

No

-

Create Distinct Channel For Others

Yes

No

No

No

No

No

-

Delete Channel

Yes

No

No

No

No

No

No

Read Channel

Yes

Yes

No

No

No

Yes

Yes

Update Channel Members

Yes

No

No

No

No

No

-

Remove Own Channel Membership

Yes

Yes

No

No

No

Yes

-

Update Channel Roles

No

No

No

No

No

No

-

Update Channel

Yes

No

No

No

No

No

-

Use Frozen Channel

Yes

No

No

No

No

No

No

Create Message

Yes

Yes

No

No

No

Yes

-

Add Links

Yes

Yes

No

No

No

Yes

-

Update Message

Yes

Yes

No

No

No

No

Yes

Pin Message

Yes

Yes

No

No

No

No

No

Delete Message

Yes

Yes

No

No

No

No

Yes

Create Reaction

Yes

Yes

No

No

No

Yes

-

Delete Reaction

Yes

Yes

No

No

No

No

Yes

Ban User

Yes

Yes

No

No

No

No

-

Edit User Role

No

No

No

No

No

No

-

Upload Attachment

Yes

Yes

No

No

No

Yes

-

Delete Attachment

Yes

Yes

No

No

No

No

Yes

Use Commands

Yes

Yes

No

No

No

Yes

-

Send Custom event

Yes

Yes

No

No

No

Yes

-

Read Message Flags

No

Yes

No

No

No

No

No

Skip Message Moderation

Yes

No

No

No

Use Cooldown Channel

Yes

No

No

No

Skip Channel Cooldown

Yes

No

No

No

Commerce

Copied!

Admin

Moderator

User

Guest

Anonymous

Channel Member

Owner

Create Channel

Yes

Yes

No

Yes

No

Yes

-

Create Distinct Channel For Others

Yes

Yes

No

Yes

No

Yes

-

Delete Channel

Yes

No

No

No

No

No

No

Read Channel

Yes

Yes

No

No

No

Yes

Yes

Update Channel Members

Yes

Yes

No

No

No

No

Yes

Remove Own Channel Membership

Yes

Yes

No

No

No

Yes

Yes

Update Channel Roles

No

No

No

No

No

No

-

Update Channel

Yes

Yes

No

No

No

No

-

Use Frozen Channel

Yes

No

No

No

No

No

No

Create Message

Yes

Yes

No

No

No

Yes

-

Add Links

Yes

Yes

No

No

No

Yes

-

Update Message

Yes

Yes

No

No

No

No

Yes

Pin Message

Yes

Yes

No

No

No

No

No

Delete Message

Yes

Yes

No

No

No

No

Yes

Create Reaction

Yes

Yes

No

No

No

No

-

Delete Reaction

Yes

Yes

No

No

No

No

Yes

Ban User

Yes

Yes

No

No

No

No

-

Edit User Role

No

No

No

No

No

No

-

Upload Attachment

Yes

Yes

No

Yes

No

Yes

-

Delete Attachment

Yes

Yes

No

No

No

No

Yes

Use Commands

Yes

Yes

No

No

No

No

-

Send Custom event

Yes

Yes

No

No

No

Yes

-

Read Message Flags

No

Yes

No

NO

No

No

No

Skip Message Moderation

Yes

Use Cooldown Channel

Yes

Skip Channel Cooldown

Yes

Team

Copied!

Admin

Moderator

User

Guest

Anonymous

Channel Member

Owner

Create Channel

Yes

Yes

Yes

No

No

Yes

No

Create Distinct Channel For Others

Yes

Yes

Yes

No

No

Yes

No

Delete Channel

Yes

No

No

No

No

No

Yes

Read Channel

Yes

Yes

No

No

No

Yes

Yes

Update Channel Members

Yes

Yes

No

No

No

No

Yes

Remove Own Channel Membership

Yes

Yes

No

No

No

Yes

No

Update Channel Roles

No

No

No

No

No

No

No

Update Channel

Yes

Yes

No

No

No

No

Yes

Use Frozen Channel

Yes

Yes

No

No

No

No

No

Create Message

Yes

Yes

No

No

No

Yes

No

Add Links

Yes

Yes

No

No

No

Yes

No

Update Message

Yes

Yes

No

No

No

No

Yes

Pin Message

Yes

Yes

No

No

No

Yes

No

Delete Message

Yes

Yes

No

No

No

No

Yes

Create Reaction

Yes

Yes

No

No

No

Yes

No

Delete Reaction

Yes

No

No

No

No

No

Yes

Ban User

Yes

Yes

No

No

No

No

No

Edit User Role

No

No

No

No

No

No

No

Upload Attachment

Yes

Yes

No

No

No

Yes

No

Delete Attachment

Yes

Yes

No

No

No

No

Yes

Use Commands

Yes

Yes

No

No

No

Yes

No

Send Custom event

Yes

Yes

No

No

No

Yes

No

Read Message Flags

No

Yes

No

No

No

No

No

Skip Message Moderation

Yes

Yes

No

No

No

No

No

Use Cooldown Channel

Yes

Yes

No

No

No

No

No

Skip Channel Cooldown

Yes

Yes

No

No

No

No

No