Error Codes

Understanding and handling API errors.

error

HTTP Status Codes

Code	Status	Description
200	OK	Request successful
201	Created	Resource created successfully
400	Bad Request	Invalid request parameters
401	Unauthorized	Missing or invalid authentication
403	Forbidden	Insufficient permissions
404	Not Found	Resource not found
429	Too Many Requests	Rate limit exceeded
500	Internal Error	Server error (contact support)

code

Error Response Format

{
  "statusCode": 400,
  "error": "validation_error",
  "message": "Width must be between 1 and 8192",
  "details": {
    "field": "w",
    "value": 10000,
    "constraint": "max:8192"
  }
}

Field	Type	Description
`statusCode`	number	HTTP status code
`error`	string	Error code for programmatic handling
`message`	string	Human-readable error message
`details`	object?	Additional error details (optional)

warning

Common Errors

invalid_api_key

The provided API key is invalid or expired.

Fix: Check your API key in the dashboard and ensure it's correctly formatted.

image_not_found

The requested image does not exist.

Fix: Verify the image path is correct and the image has been uploaded.

invalid_transform

One or more transformation parameters are invalid.

Fix: Check parameter values are within allowed ranges.

quota_exceeded

Monthly bandwidth or storage quota exceeded.

Fix: Upgrade your plan or wait for the quota to reset.

domain_not_allowed

Remote URL domain is not in the allowed list.

Fix: Add the domain to Settings → Allowed Domains.

signature_invalid

Signed URL signature verification failed.

Fix: Regenerate the signature using the correct signing secret.