Platform Features
Member Management
Bots can help manage your community by kicking, banning, and timing out rule-breakers.
Permission Hierarchy
ModVC enforces a strict role hierarchy. A bot cannot perform an action on a member who has a higher role than the bot. For example, a bot cannot kick the server owner.
To use these endpoints, your bot must be granted the specific permission during the OAuth2 join flow (e.g. KICK_MEMBERS) or have the ADMINISTRATOR permission.
Kick a Member
Kicking removes a user from the server. They can rejoin if they receive a new invite link.
POST /api/bot
Authorization: Bot YOUR_BOT_TOKEN
Content-Type: application/json
{
"action": "kick_member",
"server_id": "server_abc123",
"user_id": "user_def456"
}
Future Actions
Ban and Timeout endpoints will follow the exact same structure but will use the ban_member and timeout_member action payloads.