Skip to main content

When this happens

The server received the request but could not process it. Typical causes:
  • The body is not valid JSON.
  • The Content-Type header is missing or wrong.
  • A required path parameter is malformed (e.g. a non-UUID where one is expected).
  • A schema constraint outside Pydantic’s type system was violated (e.g. mutually exclusive fields).
If the failure is a typed schema violation (missing fields, wrong type), the server returns validation_error (422) instead.

Example response

How to fix

  1. Confirm the request body parses as JSON.
  2. Confirm Content-Type: application/json.
  3. Compare the body to the auto-generated schema in the API reference.
  4. If you are using an SDK, upgrade to the latest minor and re-run. Most bad_requests in the wild are misuse of low-level escape hatches.

SDK behaviour

Quote request_id when filing a support ticket.