Skip to main content
The API uses standard HTTP status codes and returns consistent error responses.

​
HTTP Status Codes

CodeDescription
200Success
400Bad request - invalid parameters
401Unauthorized - missing or invalid authentication
403Forbidden - insufficient permissions
404Not found - resource doesn’t exist
409Conflict - resource already exists or state conflict
422Validation error - request body failed validation
429Rate limited - too many requests
500Internal server error

​
Validation Errors

When a request fails validation (422), the response includes details about which fields failed: 
{
  "detail": [
    {
      "loc": ["body", "discord_id"],
      "msg": "field required",
      "type": "value_error.missing"
    }
  ]
}

​
Rate Limiting

Bot API keys have a configurable rate limit (default: 1000 requests/hour). When exceeded, the API returns a 429 status code. Contact an admin to adjust your rate limit if needed.