Platform Features
Audit Logs
Audit logs provide a historical record of administrative actions taken in a server, such as member kicks, role updates, and channel deletions.
Querying Logs
Bots with the VIEW_AUDIT_LOG permission can retrieve the history of a server.
GET /api/audit?serverId=SERVER_ID&limit=50
Authorization: Bot YOUR_BOT_TOKEN
Creating Log Entries
When your bot performs an action via the Bot API (like kicking a user), ModVC automatically generates an audit log entry on your behalf.
However, if your bot performs a custom action (like a custom moderation command internal to your bot's database), you can manually insert a log entry so server admins can see it in their dashboard.
POST /api/audit
Content-Type: application/json
{
"server_id": "server_123",
"user_id": "bot_123",
"action": "custom_bot_action",
"target_id": "user_456",
"details": "User flagged for spam"
}