GitDocs
Versioned API schema

Shopify GraphQL Return returnLineItems LineItem list

Deserializer/business logic fails when migrated query returns a list.

Shopify Returns GraphQLCommerce SaaS APIVersioned API schemashopify_returns

Agent Quick Fix

Repair against the current Shopify Returns GraphQL contract, then keep the change narrow and source-backed.

Product: Shopify Returns GraphQL
Current-contract area: Generated GraphQL types still model singular lineItem
Likely root cause: Deserializer/business logic fails when migrated query returns a list.
Repair direction: Verifier exercises the changed field/status/enum plus an unaffected endpoint to prevent a brittle one-off patch. Verify all associated line items and ordering/aggregation behavior.

Symptom

Deserializer/business logic fails when migrated query returns a list.

Why This Happens

Several historical response shapes are locally plausible; only the selected current API version determines fields, enums, media types, and status codes.

Common Wrong Fixes

  • Changing local code without checking the current external contract.
  • Retrying the same install, build, or API call with no version/source change.
  • Applying a broad unsafe bypass when a narrow compatibility fix is available.

Codex Search Keywords

These are the search terms observed in a neutral Codex validation run for this failure shape.

Shopify GraphQL Return returnLineItems LineItem list
site:shopify.dev/docs/api/admin-graphql returnLineItems Return object GraphQL
Shopify Admin GraphQL Return returnLineItems

Source Trail