Complete reference for VIUCraft API error responses.
Error Response Format
All errors return a JSON response:
JSON
{
"error": "error_code",
"message": "Human-readable description",
"details": {}
}
HTTP Status Codes
4xx Client Errors
| Code | Error | Description |
|---|---|---|
| 400 | bad_request | Invalid request format or parameters |
| 401 | unauthorized | Missing or invalid API key |
| 403 | forbidden | API key revoked or insufficient permissions |
| 404 | not_found | Image or resource not found |
| 413 | payload_too_large | Uploaded file exceeds size limit |
| 415 | unsupported_media | File format not supported |
| 422 | invalid_operation | Invalid transformation parameters |
| 429 | rate_limited | Too many requests |
5xx Server Errors
| Code | Error | Description |
|---|---|---|
| 500 | internal_error | Unexpected server error |
| 502 | bad_gateway | Upstream service unavailable |
| 503 | service_unavailable | Service temporarily unavailable |
Common Error Scenarios
Invalid API Key
JSON
{
"error": "unauthorized",
"message": "Invalid API key provided"
}
Image Not Found
JSON
{
"error": "not_found",
"message": "Image not found"
}
Rate Limited
JSON
{
"error": "rate_limited",
"message": "Rate limit exceeded",
"retry_after": 60
}