All firewall endpoints require SERVER_FIREWALL when authenticated with an API key.
Logs
/api/v3/servers/{serverId}/firewall/logsList firewall logs
Returns paginated firewall log entries.
serverIdRequired- Location
- path
- Type
- string
pageOptional- Location
- query
- Type
- integer
- Default
- 1
limitOptional- Location
- query
- Type
- integer
- Default
- 10
userIdOptional- Location
- query
- Type
- string
actionOptional- Location
- query
- Type
- string
/api/v3/servers/{serverId}/firewall/logsClear firewall logs
Deletes firewall log history for a server.
serverIdRequired- Location
- path
- Type
- string
Rules
/api/v3/servers/{serverId}/firewall/rulesList rules
Returns rules, statistics, and available firewall passwords.
serverIdRequired- Location
- path
- Type
- string
/api/v3/servers/{serverId}/firewall/rulesCreate rule
Creates a firewall rule.
serverIdRequired- Location
- path
- Type
- string
ruleTypeRequired- Location
- body
- Type
- string
targetTypeRequired- Location
- body
- Type
- string
targetValueRequired- Location
- body
- Type
- string
passwordIdOptional- Location
- body
- Type
- string
assignedRoleIdOptional- Location
- body
- Type
- string
/api/v3/servers/{serverId}/firewall/rulesToggle rule
Enables or disables a rule.
serverIdRequired- Location
- path
- Type
- string
idRequired- Location
- body
- Type
- number
isActiveRequired- Location
- body
- Type
- boolean
/api/v3/servers/{serverId}/firewall/rules/{ruleId}Get rule
Reads one firewall rule.
serverIdRequired- Location
- path
- Type
- string
ruleIdRequired- Location
- path
- Type
- string
/api/v3/servers/{serverId}/firewall/rules/{ruleId}Update rule
Updates a firewall rule.
serverIdRequired- Location
- path
- Type
- string
ruleIdRequired- Location
- path
- Type
- string
/api/v3/servers/{serverId}/firewall/rules/{ruleId}Delete rule
Deletes a firewall rule.
serverIdRequired- Location
- path
- Type
- string
ruleIdRequired- Location
- path
- Type
- string
Passwords
/api/v3/servers/{serverId}/firewall/passwordsList passwords
Returns firewall password metadata and owner-visible password values.
serverIdRequired- Location
- path
- Type
- string
/api/v3/servers/{serverId}/firewall/passwordsCreate password
Creates a password used by password firewall rules.
serverIdRequired- Location
- path
- Type
- string
passwordRequired- Location
- body
- Type
- string
passwordLabelRequired- Location
- body
- Type
- string
maxUsesOptional- Location
- body
- Type
- number
expiresAtOptional- Location
- body
- Type
- string
/api/v3/servers/{serverId}/firewall/passwordsToggle password
Enables or disables a firewall password.
serverIdRequired- Location
- path
- Type
- string
idRequired- Location
- body
- Type
- number
isActiveRequired- Location
- body
- Type
- boolean
/api/v3/servers/{serverId}/firewall/passwords/{passwordId}Get password
Reads one firewall password.
serverIdRequired- Location
- path
- Type
- string
passwordIdRequired- Location
- path
- Type
- string
/api/v3/servers/{serverId}/firewall/passwords/{passwordId}Update password
Updates password metadata.
serverIdRequired- Location
- path
- Type
- string
passwordIdRequired- Location
- path
- Type
- string
/api/v3/servers/{serverId}/firewall/passwords/{passwordId}Delete password
Deletes a firewall password.
serverIdRequired- Location
- path
- Type
- string
passwordIdRequired- Location
- path
- Type
- string
Bypasses
/api/v3/servers/{serverId}/bypassList bypasses
Returns active bypasses or one user's bypass.
serverIdRequired- Location
- path
- Type
- string
userIdOptional- Location
- query
- Type
- string
/api/v3/servers/{serverId}/bypassCreate bypass
Creates a temporary firewall bypass for a Discord user.
serverIdRequired- Location
- path
- Type
- string
userIdRequired- Location
- body
- Type
- string
durationOptional- Location
- body
- Type
- string
- Default
- 24h
/api/v3/servers/{serverId}/bypassRemove bypass
Removes an active bypass for a user.
serverIdRequired- Location
- path
- Type
- string
userIdRequired- Location
- query
- Type
- string
Import Bans
/api/v3/servers/{serverId}/firewall/import-bansPreview Discord bans
Lists Discord bans not already represented as firewall rules.
serverIdRequired- Location
- path
- Type
- string
/api/v3/servers/{serverId}/firewall/import-bansImport Discord bans
Creates BLOCK rules from Discord server bans.
serverIdRequired- Location
- path
- Type
- string
Rule Types
- Target type
USER- Accepted value
- Discord user ID or
alt-account-detection.
- Target type
IP- Accepted value
- IPv4 address,
vpn-proxy-detection, orwireless-detection.
- Target type
IP_RANGE- Accepted value
- IPv4 CIDR range.
- Target type
COUNTRY- Accepted value
- One or more two-letter country codes.
- Target type
CONTINENT- Accepted value
- Continent code such as
EU,NA, or a supported continent name.
- Target type
ASN- Accepted value
- Numeric ASN, with or without
ASprefix.
- Target type
DOMAIN- Accepted value
- Domain name.
- Target type
GUILD- Accepted value
- Discord server ID. Requires Business plan or higher.
{
"ruleType": "BLOCK",
"targetType": "COUNTRY",
"targetValue": "RU,CN",
"name": "Blocked countries"
}Constraints
TIMEtarget rules are rejected because time-based rules are not implemented.REQUIRE_PASSWORDrules require an active firewall password.- Ban imports require Premium, Business, or Enterprise and a bot with Discord
BAN_MEMBERSpermission. - Password labels must be unique per server.
- Bypass durations are limited to
15m,1h,6h,24h, or7d.
Firewall changes directly affect who can verify. Test restrictive rules with a known staff account before rolling them out broadly.