API transport/header semantics
Shopify Admin GraphQL API Content-Type application/graphql-response+json Accept header
The server returns a representation/status combination the client does not parse.
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: Shopify GraphQL client omits compatible Accept header
Likely root cause: The server returns a representation/status combination the client does not parse.
Repair direction: Verifier checks headers, body encoding, and status handling across success and error cases. Check correct retry classification and GraphQL error parsing.Symptom
The server returns a representation/status combination the client does not parse.
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 accept header application/graphql-response+json Shopify
Shopify Admin GraphQL API Content-Type application/graphql-response+json Accept header
Shopify Admin GraphQL API headers Accept application/json
Shopify Admin GraphQL API curl -H "Content-Type: application/json"
https://shopify.dev/docs/api/admin-graphql
https://graphql.org/learn/serving-over-http/