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

# Moderation Commands

> Disciplinary actions and chat purge commands to maintain server order.

Enforce server guidelines with fast disciplinary actions, role hierarchy enforcement, and bulk message cleanup.

## Member Sanctions

### ban

Permanently remove a disruptive user from the guild and prevent them from returning.

<Warning>
  Falcon cannot ban members whose highest role is equal to or higher than Falcon's own role. Ensure the **Falcon** role is positioned above moderator roles in **Server Settings** > **Roles**.
</Warning>

<CodeGroup>
  ```bash Syntax theme={null}
  -ban (user) [reason]
  ```

  ```bash Example theme={null}
  -ban @Spammer Raiding and advertising unauthorized links
  ```
</CodeGroup>

<AccordionGroup>
  <Accordion title="user">
    The member to ban. You can provide a direct user mention (`@User`) or their 18-digit Discord User ID.
  </Accordion>

  <Accordion title="reason">
    Optional text explaining the violation. Recorded in the server audit logs.
  </Accordion>

  <Accordion title="Aliases">
    You can also use `-b` or the slash command `/ban`.
  </Accordion>
</AccordionGroup>

***

### unban

Revoke an existing ban to allow a previously banned user to rejoin the server with an invite.

<CodeGroup>
  ```bash Syntax theme={null}
  -unban (user_id) [reason]
  ```

  ```bash Example theme={null}
  -unban 123456789012345678 Appeal accepted through support ticket
  ```
</CodeGroup>

<AccordionGroup>
  <Accordion title="user_id">
    The 18-digit Discord ID of the banned user.
  </Accordion>

  <Accordion title="reason">
    Optional reason for revoking the ban.
  </Accordion>

  <Accordion title="Slash command">
    You can also use `/unban user_id:123456789012345678`.
  </Accordion>
</AccordionGroup>

***

### kick

Remove a member from the guild. Unlike a ban, kicked members can rejoin immediately if they possess a valid server invite.

<CodeGroup>
  ```bash Syntax theme={null}
  -kick (user) [reason]
  ```

  ```bash Example theme={null}
  -kick @Troll Refusing to follow staff verbal warnings
  ```
</CodeGroup>

<AccordionGroup>
  <Accordion title="user">
    The target member to kick (mention or user ID).
  </Accordion>

  <Accordion title="reason">
    Optional explanation for the kick recorded in server logs.
  </Accordion>

  <Accordion title="Aliases">
    You can also use `-k` or the slash command `/kick`.
  </Accordion>
</AccordionGroup>

***

### mute

Temporarily suspend a member's ability to send messages, react, or speak in voice channels using Discord native timeouts.

<Tip>
  Durations can be specified using short units: `s` (seconds), `m` (minutes), `h` (hours), `d` (days), or `w` (weeks).
</Tip>

<CodeGroup>
  ```bash Syntax theme={null}
  -mute (user) (time) [reason]
  ```

  ```bash Example theme={null}
  -mute @RuleBreaker 15m Excessive caps and fast spam in #general
  ```
</CodeGroup>

<AccordionGroup>
  <Accordion title="user">
    The member to time out (mention or user ID).
  </Accordion>

  <Accordion title="time">
    The timeout duration (e.g. `60s`, `10m`, `2h`, `1d`, `7d`). Discord supports timeouts up to a maximum of 28 days.
  </Accordion>

  <Accordion title="reason">
    Optional disciplinary reason stored in the guild audit log.
  </Accordion>

  <Accordion title="Aliases">
    You can also use `-timeout`, `-tempmute`, or the slash command `/mute`.
  </Accordion>
</AccordionGroup>

***

### unmute

Lift an active timeout early before the timer expires.

<CodeGroup>
  ```bash Syntax theme={null}
  -unmute (user) [reason]
  ```

  ```bash Example theme={null}
  -unmute @RuleBreaker Early appeal approved
  ```
</CodeGroup>

<AccordionGroup>
  <Accordion title="user">
    The member whose timeout should be lifted.
  </Accordion>

  <Accordion title="reason">
    Optional reason for removing the punishment.
  </Accordion>

  <Accordion title="Aliases">
    You can also use `-untimeout` or the slash command `/unmute`.
  </Accordion>
</AccordionGroup>

***

## Chat Management

### erase

Bulk purge recent messages from the current text channel.

<Warning>
  Due to Discord API limitations, bots cannot bulk delete messages older than 14 days.
</Warning>

<CodeGroup>
  ```bash Syntax theme={null}
  -erase (amount)
  ```

  ```bash Example theme={null}
  -erase 50
  ```
</CodeGroup>

<AccordionGroup>
  <Accordion title="amount">
    The number of messages to purge from the channel (between `1` and `100`).
  </Accordion>

  <Accordion title="Aliases">
    You can also use `-purge`, `-clear`, or the slash command `/erase`.
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.