Error Response Format

All error responses are JSON and include a ‘status’ and a machine-readable ‘code’.

{
  "status": "error",
  "code": "dimensions_missing",
  "message": "Detailed error message explaining what went wrong",
  "statusCode": 400
}

Validation errors (400)

These errors occur before the auto-furnish process begins.

Status	code	Meaning
400	invalid_file	File is not a supported image/PDF, or cannot be parsed
400	multiple_pages	PDF contains more than one page
400	furniture_detected	Floor plan contains visible furniture (remove and re-upload)
400	dimensions_missing	At least one dimension must be readable
400	size_unsupported	Dimensions/scale not supported
400	file_unreadable	Low resolution or corrupted upload

These errors occur when authentication headers are missing or invalid.

Status	code	Meaning
401	unauthorized	Missing or invalid `X-API-Key` / `X-API-Secret`
403	forbidden	Key is valid but not allowed for this endpoint

Errors thrown during or after the auto-furnish request.

Status	code	Meaning
408	timeout	Processing exceeded the time limit
413	payload_too_large	File exceeds 10 MB
415	unsupported_media_type	Unsupported file type
429	rate_limited	Too many requests
500	internal_error	Unexpected internal error
503	service_unavailable	Service temporarily unavailable