When this happens
The server received the request but could not process it. Typical causes:- The body is not valid JSON.
- The
Content-Typeheader 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).
validation_error (422) instead.
Example response
How to fix
- Confirm the request body parses as JSON.
- Confirm
Content-Type: application/json. - Compare the body to the auto-generated schema in the API reference.
- 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.