{% extends "_layout.html" %} {% set title = "Invalid request" %} {% set status = "400 Bad Request" %} {% set description = "A malformed request. Often answered below the handler, untyped." %} {% block main %}
The request was malformed: a body that does not validate, a missing or contradictory parameter, or a request member or query parameter this contract does not define — which is refused, never ignored, so a misspelled filter cannot read as an answer.
That includes a member the server owns, such as archived_at or id,
which a request never carries, and a design, jobname, flow,
step or index outside [A-Za-z0-9][A-Za-z0-9._-]{0,99}; a limit or
cursor that appears more than once; a descriptor.needs string outside
[a-z0-9][a-z0-9._-]{0,63}; a subject_token that is not a compact JWT or is
over 4096 characters; a machine_id_hash and machine_id_source that
disagree, or are malformed; and an id sent to POST /v1/auth/browser that is not 1 to
200 printable characters. An endpoint that takes a token answers 401 before it checks
the request, so a malformed request with no credential is never this type.
At POST /v1/auth/token and POST /v1/auth/device a malformed request is
invalid_request, in the OAuth shape, and an unknown parameter is ignored — except
actor_token, audience and resource sent with a value, which are
refused invalid_request. There a missing required parameter, grant_type
included, is invalid_request, a parameter sent with no value counts as omitted, and a
repeated parameter is invalid_request.
detail for which field.An untyped answer is expected here. This refusal is often produced below the
request handler — by routing, the framework or a proxy — and then it arrives as the web
server’s own page, not as application/problem+json, and has no type
at all. Treat a non-problem+json 400 exactly as you would this type.
{
"type": "https://sc.example.com/server-errors/invalid-request",
"title": "Invalid request",
"status": 400,
"detail": "...",
"instance": "/v1/jobs/01J9...",
"trace_id": "4bf92f3577b34da6a3ce929d0e0e4736"
}
detail is prose and may be reworded at any time. Branch on type — never parse detail.
| any endpoint | Request validation. |
POST /v1/jobs |
A descriptor.sources entry whose keypath is not a
dataroot in one of the two places SiliconCompiler keeps one:
["library", name, "dataroot", root], or a task’s own,
["tool", tool, "task", task, "dataroot", root]. The server does not
guess what owns a dataroot. An entry carrying name or
dataroot, the members keypath replaced, is refused as any
unknown member is. |
invalid-cursor is specifically a bad pagination cursor.
unsupported-media-type is a body of the wrong type.