Error Reference
HTTP Status Codes
| Status | Meaning | Common recovery |
|---|---|---|
400 | Bad request | Check the request body and required fields |
401 | Unauthorized | Add or rotate the bearer token/API key |
403 | Forbidden | Use a key with the right scope |
404 | Not found | Confirm the route and resource ID |
409 | Conflict | Check for duplicate names or already-bound resources |
429 | Rate limited | Back off and retry later |
500 | Server error | Retry with backoff; report persistent failures |
Error Body
Most Django REST Framework errors include a detail field:
{
"detail": "Authentication credentials were not provided."
}
Validation errors may be field-shaped:
{
"name": ["This field is required."]
}
Route Checks
If a request returns 404, confirm the endpoint in API Endpoints or the generated OpenAPI document:
https://docs.ravi.app/openapi.json
API calls should use https://api.ravi.app. Documentation and machine-readable reference files are served from https://docs.ravi.app.