API transport/header semantics
Shopify Admin GraphQL validation error HTTP status code 400 retry middleware client error transient transport failure
Retry middleware treats a client error as a transient transport failure.
Agent Quick Fix
Repair against the current Shopify Admin GraphQL contract, then keep the change narrow and source-backed.
Product: Shopify Admin GraphQL
Current-contract area: GraphQL validation error now uses more granular HTTP status
Likely root cause: Retry middleware treats a client error as a transient transport failure.
Repair direction: Verifier checks headers, body encoding, and status handling across success and error cases. Check correct retry classification and GraphQL error parsing.Symptom
Retry middleware treats a client error as a transient transport failure.
Why This Happens
Request bodies remain locally valid while the external API changes required Accept/Content-Type or success/error status interpretation.
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 Admin GraphQL validation error HTTP status code 400 retry middleware client error transient transport failure
site:shopify.dev Admin GraphQL status codes validation error HTTP 400
Shopify Admin API GraphQL status and error codes 400 200
Shopify GraphQL Admin API error codes THROTTLED ACCESS_DENIED status code
https://shopify.dev/docs/api/admin-graphql
'Status and error codes' in https://shopify.dev/docs/api/admin-graphql