---
title: >-
  The X-Shopify-API-Deprecated-Reason HTTP header will return actual GraphQL
  deprecations if any - Shopify developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: >-
    https://shopify.dev/changelog/posts/graphql-return-actual-deprecation-reasons
  md: >-
    https://shopify.dev/changelog/posts/graphql-return-actual-deprecation-reasons.md
metadata:
  effectiveApiVersion: 2025-04
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Update
    handle: update
  indicatesActionRequired: false
  createdAt: '2025-01-31T15:37:11-05:00'
  postedAt: '2025-02-24T12:00:00-05:00'
  updatedAt: '2025-02-05T11:50:58-05:00'
  effectiveAt: '2025-02-24T12:00:00-05:00'
---

February 24, 2025

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

DateFebruary 24, 2025

Version[2025-04](https://shopify.dev/changelog?api_version=2025-04)

FlagsUpdate

SurfacesAPI

Affected APIs[Admin GraphQL API](https://shopify.dev/changelog?api_type=admin-graphql)

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`