{% 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.

What to do

  1. Read detail for which field.
  2. Fix the request; the same request returns the same answer.

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.

The body

{
  "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.

Where it comes from

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.
{% include "_help.html" %}

What this is not

invalid-cursor is specifically a bad pagination cursor.

unsupported-media-type is a body of the wrong type.

{% endblock %}