Errors / invalid_request

invalid_request

400, 411, 422 The request is not right

Something in the call is missing or wrong. detail says what, in plain words.

When it happens#

• A field the API does not know, such as no field "nmae" here: a misspelt field is refused, never quietly ignored.
• A value out of its range, such as cpus is 2, 4, 8 or 16 or wait_s is between 0 and 600.
• A body that is not one JSON object.
• A path in a machine that does not begin home/ or work/, or that climbs out with ...
• 411: a file written without its length in Content-Length.
• 422: an Idempotency-Key sent again with a different request.

What to do#

Put the call right as detail says. For a 422, give the new request a new Idempotency-Key.

Send it again? Not unchanged: the same call gets the same answer.

Every code, and how to read a refusal: Errors.