Skip to main content
HTTP Status: 400
{
  "code": "validation_error",
  "message": "One or more parameters are invalid",
  "details": "Invalid value for 'format'. Expected: png, jpg, webp",
  "request_id": "req_abc123"
}

Reasons and How to Fix

Invalid Parameter Value

A parameter has an invalid value that doesn’t match the expected options. Common issues:
  • format must be one of: png, jpg, webp
  • channels must be one of: rgba, rgb
  • size must be one of: full, preview, small, medium, large
  • crop must be a boolean: true or false

Incorrect Data Types

Parameters must be the correct type.
# ❌ Wrong - crop should be boolean, not string
-F "crop=yes"

# ✅ Correct
-F "crop=true"

Missing Required Parameters

The image_file parameter is required for the /remove endpoint.
# ❌ Wrong - missing image
curl -X POST https://api.poof.bg/v1/remove -H "x-api-key: KEY"

# ✅ Correct
curl -X POST https://api.poof.bg/v1/remove \
  -H "x-api-key: KEY" \
  -F "image_file=@photo.jpg"

Valid Parameter Reference

ParameterTypeValid Values
image_filefileRequired. Max 20MB
formatstringpng, jpg, webp
channelsstringrgba, rgb
bg_colorstringHex, RGB, or color name
sizestringfull, preview, small, medium, large
cropbooleantrue, false

Need Help?

Contact us at support@poof.bg with your request_id.