Skip to main content
Below is a comprehensive list of all possible error codes you might encounter when using the Poof API. Each error includes a description, HTTP status code, and a link to detailed documentation about how to handle it.

​
Error Reference Table

Error CodeDescriptionHTTP Status
authentication_errorInvalid or missing API key401
permission_deniedAccess to this resource is forbidden403
payment_requiredInsufficient credits or plan upgrade needed402
rate_limit_exceededToo many requests429
validation_errorInvalid request parameters400
missing_imageNo image file in request400
image_too_largeImage exceeds size limit400
upstream_errorProcessing service failed502
internal_server_errorServer error500

​
Error Response Format

All errors follow a consistent JSON response format: 
{
  "code": "error_code",
  "message": "Human-readable description",
  "details": "Additional context or troubleshooting steps",
  "request_id": "req_abc123xyz"
}
The request_id is useful for support — include it when contacting us about an issue.