3.8. Audit Log
The Audit Log records every state-changing action taken through the TicketBot dashboard, so you can answer questions like "who deleted that panel last week?" or "when did our log channel change?" Each entry captures the action, the actor, the timestamp, and (where applicable) a full before-and-after diff of what changed.
Accessing the Audit Log
The Audit Log lives in the dashboard sidebar of every server you manage at /dashboard/<server-id>/logs. Only users in the server's DashboardAdmin list (added via the bot's /admin addadmin command) can view it. Each server's log is isolated to that server — you will never see another server's entries.
What Gets Tracked
Every state-changing action that goes through the dashboard emits an audit log entry. Read-only actions (browsing tickets, viewing transcripts, listing panels) are not logged — only changes are.
| Category | Tracked Actions |
|---|---|
| Settings | Any change to your server settings (channels, colors, autoclose, naming scheme, timezone, etc.) with a full before/after diff. |
| Panels | Creating, editing, deleting, posting to Discord, and re-deploying single panels. |
| Multi-Panels | Creating, editing, deleting, posting, and re-deploying multi-panels. |
| Tags | Creating, editing, and deleting tags. |
| Modals | Creating, editing, and deleting modal forms. |
| Teams | Creating and deleting support teams, plus adding and removing role members from a team. |
| Blacklist | Adding and removing users from the ticket blacklist. |
| Tickets | Claiming, closing, and unclaiming tickets from the dashboard, plus messages sent into a ticket via the dashboard's "Send Message" feature. |
| Whitelabel | When a Whitelabel bot owner links or unlinks their bot to your server. |
Actions taken via Discord slash commands (for example, /blacklist in chat) are not currently captured in the dashboard's Audit Log — only dashboard actions are.
Reading an Entry
Each row in the Audit Log shows:
- Action title — e.g. "Panel Created", "Settings Updated", "Blacklist User Added". A colored icon hints at whether the action created (green), updated (amber), or deleted (red) something.
- Actor — the Discord user who performed the action, resolved to their username.
- Timestamp — formatted in your server's configured timezone. Hover for the relative time ("2 hours ago").
- Details — click to expand and see the contextual data for the action.
For updates, the Details panel renders a clean before-and-after diff — e.g. "Ticket Naming Scheme: ticket-old → ticket-{username}". For first-time setting of a value, the diff shows "Set to X" instead of a confusing "none → X". For creates and deletes, the Details panel lists the relevant context (name, channel, target user, etc.).
Filters
At the top of the Audit Log page you'll find three filter controls:
- Category — narrow the list to a specific area (Settings, Panels, Tags, Modals, Teams, Blacklist, Tickets, Whitelabel).
- Actor — show only entries performed by a specific Discord user. Paste their 17-19 digit user ID.
- Time range — presets for the last 24 hours, 7 days, 30 days, or all time.
Combine filters freely. A "Clear all" link appears when any filter is active, and entries load 50 at a time with a "Load more" button for older history.
Retention
Audit history is retained based on your server's subscription tier:
| Tier | Retention |
|---|---|
| Free | 90 days |
| Premium | 1 year (365 days) |
| Whitelabel | 1 year (365 days) |
Retention is enforced automatically by a daily cleanup job that prunes entries older than your tier's window. No action is required on your part — if you upgrade to Premium, your retention immediately extends to 1 year going forward. Whitelabel-served guilds inherit Premium retention from the bot owner's subscription.
FAQ
Why don't I see actions from slash commands?
The Audit Log currently only captures dashboard-originated actions. Bot-side slash commands like /blacklist and /setup are not yet logged — this may be added in a future update.
Can I delete or edit entries?
No. Audit Log entries are append-only and cannot be edited or deleted by anyone, including the server owner. This is by design — an audit trail you can edit is no audit trail at all. Entries are removed only by the automatic retention cleanup based on your subscription tier.
Does the audit log show subscription or billing actions?
No. Subscription management, payment, and other user-account-scoped actions are private to the account holder and intentionally excluded from the per-server Audit Log. The Audit Log is scoped strictly to actions that affect your server's configuration and operation.