Error Codes & Rate Limits

Standardized error codes ensure your application can handle edge cases gracefully without crashing.

Common HTTP Status Codes

• 400 Bad Request: Your JSON payload is malformed or missing required fields (e.g. missing server_id).
• 401 Unauthorized: Your Bot Token or Bearer Token is missing or invalid.
• 403 Forbidden: You authenticated successfully, but you lack the specific permission (e.g. KICK_MEMBERS) to perform the action.
• 429 Too Many Requests: You have hit the rate limit.
• 500 Internal Server Error: Something went wrong on ModVC's infrastructure. Retry with exponential backoff.

Rate Limits

ModVC restricts API requests to prevent abuse. By default, bots are limited to 50 requests per second across all endpoints.

If you exceed this limit, you will receive a 429 response. You must wait before sending further requests.