Errors

Waterfall uses standard HTTP status codes for success and failure.

Status	Meaning
`200`	Success
`400`	Invalid request payload/inputs
`401`	Missing API key
`403`	Invalid API key
`404`	Resource/job not found
`429`	Rate limit exceeded
`500`	Internal server error

Error response shape

All error responses return a JSON body with the following structure:

{
  "status": "error",
  "message": "Bad request",
  "error": ["Bad request"],
  "category": "VALIDATION",
  "code": "VALIDATION_BAD_REQUEST"
}

Field	Description
`status`	Always `"error"`
`message`	Human-readable summary
`error`	Array of error detail strings
`category`	Broad error group — e.g. `VALIDATION`, `NOT_FOUND`, `RATE_LIMIT`
`code`	Specific error type — for the full list refer to the OpenAPI specification