Disabling Channels

LAST EDIT Mar 18 2024

Disable a channel

Copied!

Disable a channel prevents users from viewing or creating messages on that channel. Any client-side read or write operations will results in a 403 Not Allowed error. You can't fetch the channel client-side, but you can query channels and receive them, you will have to use disabled:false on your filters in order to filter the disabled channels out. The channel remains usable server-side and data can still be exported.

Channels can be re-enabled which restores historical messages and allows creation of new messages again.

To prevent new messages from being created, while still being able to read previous messages, freeze the channel instead.

Freeze a channel

Copied!

Freezing a channel will disallow sending new messages and sending / deleting reactions. Sending a message to a frozen channel will return a message of type error. Sending and deleting reactions to frozen channels will result in a 403 Not Allowed error. User roles with the UseFrozenChannel permission are still able to use frozen channels as if they weren't frozen. By default no user role has the UseFrozenChannel permission.

Unfreeze a Channel

Copied!

Granting the Frozen Channel Permissions

Copied!

Since by default no role has the UseFrozenChannel permission, you can edit the channel type to grant the permission to a role (this is only allowed via server side API calls). Read more about user permissions here