Variable of required type was not provided API Origin: Application & API OSI layer 7 · Application Last updated 13 Oct 2026

GraphQL: Variable "$id" of required type "ID!" was not provided.

A GraphQL operation declares a non-null variable, but the request didn’t include a value for it.

Exact message you may see of required type was not providedVariable "$id" of required type "ID!" was not providedgot invalid value
Seen on: REST API

Meaning

Variables must be sent in the variables object with exactly the declared name. Typos, sending them inside the query string, or undefined values (dropped by JSON.stringify) cause this.

Common causes

  • Variable missing from the variables object
  • Name mismatch ($userId vs $id)
  • Value undefined so JSON drops it
  • Variables sent as a string instead of an object

⚡ Quick fix

  1. Send variables: { id: "123" } with the same names
  2. Validate inputs before calling
  3. Make the variable nullable if it’s optional

Detailed fix by platform

JavaScript

  1. javascript
    await fetch("/graphql", {
      method: "POST", headers: { "Content-Type": "application/json" },
      body: JSON.stringify({ query: "query($id: ID!) { user(id: $id) { name } }", variables: { id } })
    });

How to diagnose

  1. Request — variables object contents
  2. Names — Declared vs sent

🔧 Still not fixed?

Many errors look alike. If the steps above didn’t solve it, one of these is probably what you’re facing:

Where this error sits

Origin: Application & API. Errors that are often confused with or caused by this one (click to open):

400 — HTTP 400 Bad Request (HTTP)400additionalProperties — API Error: Request failed schema validation (must NOT have additional properties / Additional properties are not allowed) (API)additionalPropertiesCannot return null for non-nullable field — GraphQL: Cannot return null for non-nullable field Query.user (API)Cannot return null fo…file_type_not_allowed — Upload error: File type not allowed / unsupported file type (API)file_type_not_allowedGraphQL Syntax Error — GraphQL: Syntax Error: Expected Name, found <EOF> / Unexpected } (API)GraphQL Syntax ErrorGRAPHQL_VALIDATION_FAILED — GraphQL: Cannot query field "x" on type "Y" (API)GRAPHQL_VALIDATION_FA…invalid_date — API Error: Invalid date format — expected ISO 8601 (YYYY-MM-DDTHH:mm:ssZ) (API)invalid_dateinvalid_id — API Error: Invalid ID format (not a valid UUID / malformed identifier) (API)invalid_idVariable …

Explore the map of this error Full error map →

🧠 Still stuck? Analyze your error

Paste the full message, response headers or stack trace — we'll detect the platform and point to the most likely cause.

💬 What worked for others

No tips yet — did something else fix this for you?

Share what worked for you

Tips are checked by an editor before they appear. Links are removed.