Settings reference
Moderation case and queue fields.
| Field | Type | Default | Meaning |
|---|---|---|---|
caseNumber | integer | Next per guild | Allocated by reading the highest case number and retrying unique conflicts up to 5 times. |
action | string | Required | Cases use WARN, KICK, TIMEOUT, BAN, UNBAN or UNMUTE. Dashboard queue accepts WARN, KICK, TIMEOUT. |
targetId / targetTag | string | Required | Moderated user id and username at action time. |
moderatorId / moderatorTag | string | Required | Moderator user id and username, or the bot/System for automatic unbans. |
reason | string | Command-specific | Slash warn/kick/timeout require a reason, ban/unban/unmute default to No reason provided when omitted. Dashboard limit: 512 characters. |
duration | integer seconds or null | null | Timeout or temp-ban length. Dashboard timeout must be at least 60 seconds. |
expiresAt | DateTime or null | null | Set for TIMEOUT and temporary BAN when a duration is present. |
PendingBotAction.status | PENDING, DONE, FAILED | PENDING | Dashboard queue lifecycle. Errors are stored in error. |
| Dashboard timeout choices | seconds | 600 UI initial | 60, 300, 600, 3600, 21600, 43200, 86400, 259200, 604800, 2419200. |
| Temp-ban sweep | interval | 60 seconds | Finds expired BAN cases and records an UNBAN case after removal or manual-unban detection. |
Case history
The API returns cases in createdAt descending order, 20 per page, with total and page counts for the dashboard.