The X-Shopify-API-Deprecated-Reason HTTP header will return actual GraphQL deprecations if any

As of 2025-04, the X-Shopify-API-Deprecated-Reason HTTP header will return the list of detected deprecations instead of a generic URL.

Example

As of 2025-04: X-Shopify-API-Deprecated-Reason: Shop.products, Shop.productVariants Before 2025-04: X-Shopify-API-Deprecated-Reason: https://shopify.dev/api/usage/versioning#deprecation-practices