Skip to main content

Error Response Format

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

Validation Errors (400)

These errors occur before the auto-furnish process begins.
StatusMessageMeaning
400Invalid file typeMust be JPG, PNG, or single-page PDF
400Multiple pages detectedPDF contains more than one page
400Dimensions not visibleNo readable dimension found on the plan
400Mixed scale detectedConflicting scale indicators on the plan
400Furniture detectedVisible furniture found — remove and re-upload
400Plan size unsupportedFile too large or resolution not supported
400Invalid inputGeneral input validation failure

Authentication Errors (401 / 403)

These errors occur when authentication headers are missing or invalid.
StatusMessageMeaning
401API key and secret requiredMissing headers
401Authentication failedIncorrect key or secret
403Not allowedKey is valid but not authorized for this endpoint

Processing Errors (408 / 422 / 500)

Errors thrown during or after the auto-furnish request.
StatusMessageMeaning
408AI service request timeoutProcessing exceeded the maximum time
422File unreadableCorrupted, low quality, or unprocessable image
500AI service errorTemporary internal model failure
500Internal server errorGeneral back-end failure

Example Error Response

{
  "status": "error",
  "message": "Dimensions not visible",
  "code": 400
}

How to Handle Errors

  • 400-level errors → Fix the input and retry
  • 401/403 errors → Check authentication headers
  • 408 errors → Retry with a clearer or smaller file
  • 422/500 errors → Retry after a short delay; contact support if persistent