Invalid argument

invalid_argumentHTTP 400Retrying the same request will not help

The request does not match the schema, so nothing ran.

Why it happens

• An argument has the wrong type, or is missing when the schema requires it.
• A value is outside the @range the schema declares, such as qty: 50 where the maximum is 10.
• The batch envelope is not valid JSON, or a shape does not parse.

What to do

• Read detail: it names the argument or the position in the request.
• Compare the request with the schema, or open the explorer, which shows every argument with its type and range.

What it looks like

Inside a batch, the operation's frame carries it:

{
  "id": 1,
  "error": {
    "code": "invalid_argument",
    "message": "ops[0].args.qty: must be at most 10"
  },
  "fin": true
}

When the whole request is refused over HTTP, the answer is a problem document:

{
  "type": "https://eddyboutros.github.io/rayfold/errors/invalid_argument",
  "title": "invalid argument",
  "status": 400,
  "detail": "ops[0].args.qty: must be at most 10",
  "code": "invalid_argument"
}

See also all error types and the errors chapter of the specification.