Moderation

Block users, mute/ban users in threads, and report messages

📄️ Block user

Blocks a user from sending messages to the current user. Blocked users cannot start new conversations or send messages in existing conversations with the blocker. Users cannot block themselves or administrators. Role-based restrictions and immunity rules are applied via the `restrictBlockUsers` and `restrictBlockUsersImmun` settings.

📄️ Unblock user

Removes a block on a previously blocked user, allowing them to send messages again. The user must have been blocked first.

📄️ Mute user in thread

Mutes a user within a specific thread, preventing them from sending messages for a duration. Requires moderator permission in the thread. The target user must be a current participant. The mute automatically expires after the given number of minutes.

📄️ Unmute user in thread

Removes a mute restriction from a user in a thread, allowing them to send messages again. Requires moderator permission.

📄️ Ban user from thread

Bans a user from a thread — removes them as a participant and prevents them from rejoining. Requires moderator permission. The ban automatically expires after the given number of minutes. The user is immediately removed from the thread upon banning.

📄️ Unban user from thread

Removes a ban restriction from a user, allowing them to rejoin the thread. Requires moderator permission. Note that unbanning does not automatically re-add the user as a participant — they must rejoin or be re-invited.

📄️ Lift call ban

Lifts a ban from the conversation's group calls (Better Messages 3.2), the ban a moderator gives with **Remove and Ban from Calls** in a group call (`/groupCallAdmin` with `act` `ban_participant`). The user may join the calls of the conversation again at once. A ban from the conversation itself is lifted separately with `/thread/{id}/unbanUser`. Requires moderator permission in the conversation. Fires the `better_messages_user_unrestricted` action with the type `call_ban` when a ban was lifted.

📄️ Report message

Reports a message for moderator review. Each user can only report a specific message once. Users cannot report their own messages. The report category must be one of the allowed categories (default: inappropriate, spam, harassment, offensive, other — customizable via the `better_messages_get_report_reasons` filter). The description is limited to 500 characters by default (customizable via filter).

📄️ Get report reasons

Returns available report reason categories for a specific message. Also checks whether the current user has already reported this message — returns an error if they have. The default categories are inappropriate, spam, harassment, offensive, and other, but they can be customized via the `better_messages_get_report_reasons` filter.