GraphQL API Deprecation Notice: be more clear about what is deprecated

[mariusa]

Overview/summary

On various GraphQL calls, sometimes 'API Deprecation Notice' error is shown.
The message is generic: "message":"https://shopify.dev/api/usage/versioning#deprecation-practices"

Please make the message point out what exactly was deprecated, since this is known on SHopify servers executing the call and producing the message.

Current behaviour: Besides reading the docs, one now has to remove most of the fields, see the error gone, then add a few of the at a time to figure out the problematic field.
And sometimes the docs aren't helpful, eg implemented this
https://shopify.dev/docs/api/admin-graphql/2025-01/mutations/productUpdate?language=Node.js

and the error is

{"message":"https://shopify.dev/api/usage/versioning#deprecation-practices","path":"https://test1.myshopify.com/admin/api/2024-10/graphql.json","body":"{\"query\":\"\\nmutation UpdateProductWithNewMedia($input: ProductInput!, $media: [CreateMediaInput!]) {..."}

Thanks

[lizkenyon]

Hi there 👋

I agree that this experience could be improved!

Right now the this package returns, what is returned by the API itself, so at the package level there is not too much more we can do right now.

I would recommend creating a post describing this issue in the .dev community. Posting here will get it automatically flagged to the owning team, and will help with their prioritization.