Skip to main content
Status: 400 Bad Request
Code:   BAD_REQUEST | VALIDATION_ERROR
Type:   https://docs.bedrock.cv/errors/bad-request

​
Description

The request could not be processed because it is malformed or contains invalid values. There are two variants:

​
Validation errors (VALIDATION_ERROR)

One or more fields in the request body are missing, have the wrong type, or contain out-of-range values. The response includes an errors object with field-level details. 
{
  "type": "https://docs.bedrock.cv/errors/bad-request",
  "title": "Bad Request",
  "status": 400,
  "detail": "One or more request fields are invalid.",
  "code": "VALIDATION_ERROR",
  "request_id": "req_01JABCD123",
  "errors": {
    "overlay_id": ["Required field"],
    "options.confidence": ["Must be between 0 and 1"]
  }
}

​
General bad requests (BAD_REQUEST)

The request has a structural or protocol-level issue. No errors object is included. 
{
  "type": "https://docs.bedrock.cv/errors/bad-request",
  "title": "Bad Request",
  "status": 400,
  "detail": "Unsupported API version: 99. Supported versions: 1",
  "code": "BAD_REQUEST",
  "request_id": "req_01JABCD123"
}

​
Common Causes

  • Missing required fields in the request body
  • Invalid field types (e.g., string where number expected)
  • Values outside allowed ranges
  • Malformed JSON in the request body
  • Unsupported API version in X-API-Version header
  • Request body exceeds maximum size

​
Resolution

Check the code field to determine the variant. For VALIDATION_ERROR, inspect the errors object for specific field issues. For BAD_REQUEST, check the detail field for specifics.