API transport/header semantics
Shopify Admin GraphQL HTTP headers Content-Type Accept application/json
Requests pass locally but fail behind a proxy with strict content negotiation.
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: Proxy/cache varies behavior on new media type
Likely root cause: Requests pass locally but fail behind a proxy with strict content negotiation.
Repair direction: Verifier checks headers, body encoding, and status handling across success and error cases. Check correct retry classification and GraphQL error parsing.Symptom
Requests pass locally but fail behind a proxy with strict content negotiation.
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.
site:shopify.dev Admin GraphQL content type accept application/graphql-response+json
Shopify Admin GraphQL HTTP headers Content-Type Accept application/json
Shopify GraphQL Admin API endpoint headers Content-Type application/json
https://shopify.dev/docs/api/admin-graphql
'Content-Type' in https://shopify.dev/docs/api/admin-graphql