API

invalid_request

HTTP 400. Invalid request

What it means

The request is malformed in a way that fits no narrower code.

What to do

Read detail and the errors list, fix the request and send it again. If the same request keeps failing, check the operation reference for the exact shape.

Retrying

Do not retry the same request. Change it first.

Extra members

errors: Per-field problems, each with a JSON pointer, a code and a message.

Example

json

{
  "type": "https://reuseforge.com/docs/api/errors/invalid_request",
  "title": "Invalid request",
  "status": 400,
  "detail": "The request could not be understood.",
  "instance": "/api/v1/items/acme/invoice-extractor",
  "code": "invalid_request",
  "request_id": "req_c4v8n2m6x1z3",
  "errors": [
    {
      "pointer": "#/limit",
      "code": "invalid",
      "message": "limit must be an integer."
    }
  ]
}

Every error is application/problem+json (RFC 9457). Branch on code, show detail to people and quote request_id when you ask for help. See the error catalogue.