/purge

Configure and run autopurge to kick unverified members and ban known scammers.

Manage SecurityBot's autopurge feature. Autopurge runs on a recurring schedule and removes unverified members and known scammers; you can also run a one-time manual purge.

---

Usage

Subcommand	Options	Permission	Tier	Description
run	None	Admin	Premium	Runs a one-time manual purge immediately
enable	None	Admin	Premium	Enables scheduled autopurge (shows a confirm prompt)
disable	None	Admin	All tiers	Disables scheduled autopurge
view	None	Admin	All tiers	Shows current autopurge state and behavior

Example

/purge view

/purge enable

/purge run

---

Subcommands

/purge run

Premium Feature -- /purge run requires a Premium subscription. Compare plans →

Runs a one-time manual purge immediately. SecurityBot shows a "starting purge" message, then updates it with the results: the number of members kicked and banned. A PURGE_COMPLETION_ALERT is also sent to the configured log channel.

/purge enable

Premium Feature -- /purge enable requires a Premium subscription. Compare plans →

Enables scheduled autopurge for your server. SecurityBot first shows a confirmation prompt with Confirm and Cancel buttons; clicking Confirm turns autopurge on, and clicking Cancel leaves it off.

Once enabled, autopurge runs on a recurring schedule (every 30 minutes) and will:

• Kick unverified members (no roles, joined more than 5 minutes ago).

• Ban members listed as known scammers in the SecurityBot scammer list.

/purge disable

Available on all tiers -- admins can always turn autopurge off, even on the free tier.

Disables scheduled autopurge for your server. The next scheduled run will not execute. There is no confirmation step.

/purge view

Available on all tiers

Shows whether autopurge is currently enabled and a summary of what it does. Free-tier servers also see an upgrade prompt explaining that enabling autopurge requires Premium.

---

Behavior

• Kicks members who have no roles and joined more than 5 minutes ago (unverified).

• Bans members who are flagged in the SecurityBot scammer list.

• Manual runs (/purge run) and scheduled runs both report results to the configured log channel.

---

Permissions

Administrator -- All /purge subcommands require the SecurityBot admin role, Discord ADMINISTRATOR permission, or server ownership.