> ## Documentation Index
> Fetch the complete documentation index at: https://docs.katofficial.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Global Moderation

> Moderation actions applied across every server the bot has joined

The Global Moderation cog applies moderation actions across every server the bot has joined simultaneously. Actions are executed concurrently across guilds using a semaphore of 5 concurrent operations.

All commands in this cog require the globally trusted or bot owner permission.

## Command Groups

All commands are nested under `/global`.

### `/global moderation`

| Command                         | Description                                                                                         |
| ------------------------------- | --------------------------------------------------------------------------------------------------- |
| `/global moderation ban`        | Bans a user from every guild the bot has joined. Optionally DMs the target and posts an action log. |
| `/global moderation softban`    | Bans and immediately unbans a user in every guild to purge recent messages without keeping the ban. |
| `/global moderation kick`       | Kicks a user from every guild the bot has joined.                                                   |
| `/global moderation timeout`    | Times out a user in every guild the bot has joined.                                                 |
| `/global moderation untimeout`  | Removes a timeout from a user in every guild the bot has joined.                                    |
| `/global moderation unban`      | Unbans a user from every guild the bot has joined.                                                  |
| `/global moderation requestban` | Submits a ban request for approval by a globally trusted user or bot owner.                         |
| `/global moderation massban`    | Bans multiple users from every guild the bot has joined.                                            |
| `/global moderation massunban`  | Unbans multiple users from every guild the bot has joined.                                          |
| `/global moderation sync_bans`  | Syncs the global ban list to a specific guild or all guilds.                                        |
| `/global moderation status`     | Shows the global moderation status and ban record for a user.                                       |
| `/global moderation quarantine` | Quarantines a user globally (restricts their permissions across all guilds).                        |

### `/global management`

| Command                          | Description                                                                                                                                  |
| -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| `/global management trust`       | Grants or revokes the globally trusted permission for a user or role. Actions: `add_user`, `remove_user`, `add_role`, `remove_role`, `list`. |
| `/global management appeal_link` | Sets or clears the global ban appeal link sent in punishment DMs.                                                                            |

## Request Approval

When `/global moderation requestban` is used, an approval message is dispatched to a configured channel. Globally trusted users and bot owners can approve or deny the request.