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
Request bodies remain locally valid while the external API changes required Accept/Content-Type or success/error status interpretation.
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.Validation Status
Codex searched organically in the validation run. No no-web counterfactual is attached to this page yet.
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.
Verification
Verifier checks headers, body encoding, and status handling across success and error cases. Check correct retry classification and GraphQL error parsing.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