# Shopify Admin GraphQL 2025-01 content-type application/graphql legacy content type 4xx

Status: search-observed
Product: Shopify Admin GraphQL
Last verified: 2026-06-25
Canonical HTML: https://gitdocs.org/fix/shopify-admin-graphql-2025-01-content-type-application-graphql-legacy-content-type-4xx
Machine JSON: https://gitdocs.org/api/fixes/shopify-admin-graphql-2025-01-content-type-application-graphql-legacy-content-type-4xx.json

## Exact Symptom

See the observed Codex queries below.

## Diagnosis

Request bodies remain locally valid while the external API changes required Accept/Content-Type or success/error status interpretation.

## Fix

```
Verifier checks headers, body encoding, and status handling across success and error cases. Check correct retry classification and GraphQL error parsing.
```

## Avoid

- 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.

## Observed Codex Queries

- Shopify Admin GraphQL 2025-01 content-type application/graphql legacy content type 4xx
- site:shopify.dev changelog GraphQL content-type application/graphql Shopify Admin API
- Shopify Admin GraphQL API request headers Content-Type application/json
- https://shopify.dev/docs/api/admin-graphql
- https://shopify.dev/docs/api/release-notes/2025-01

## Sources

- Shopify GraphQL over HTTP changes: https://shopify.dev/changelog/graphql-over-http
- Official reference opened by Codex: https://shopify.dev/docs/api/admin-graphql
- Official reference opened by Codex: https://shopify.dev/docs/api/release-notes/2025-01