Errors
All error responses follow the standard response format:
JSON
{
"success": false,
"error": "Description of what went wrong."
}Status Codes
| Status | Meaning |
|---|---|
400 | Bad request -- missing or invalid parameters |
401 | Unauthorized -- missing or invalid API key |
403 | Forbidden -- API key lacks the required scope |
404 | Not found -- resource doesn't exist or isn't accessible |
429 | Rate limited -- too many requests |
500 | Server error |
Common Errors
Authentication
JSON
// Missing API key
{ "success": false, "error": "API key is required" }
// Invalid or expired key
{ "success": false, "error": "Invalid API key" }Authorization
JSON
// Key doesn't have the required scope
{ "success": false, "error": "API key does not have the required scope: documents:read" }Validation
JSON
// Missing required field
{ "success": false, "error": "Title is required" }
// Invalid server access
{ "success": false, "error": "Invalid server_id or you don't have access to this server" }Rate Limiting
JSON
// Too many requests
{ "success": false, "error": "Rate limit exceeded. Try again later." }When rate limited, wait before retrying. The default limit is 60 requests per minute.