Navigating the 'API Gone' Error: Publishing Videos to Your Shopify Shop Feed

Hey everyone! As a Shopify migration expert and someone who loves digging into what's happening in the community, I wanted to share some really crucial insights from a recent discussion that popped up. It’s about a tricky situation with the Shop Partners API, specifically around publishing videos to your Shop app feed. If you’re a store owner relying on programmatic ways to manage your video content on Shop, you’ll want to pay close attention to this.

The Mystery of the Vanishing API: What Happened to mediaCreate?

One of our community members, Ashish, hit a wall trying to use the Shop Partners API. His goal was pretty clear: post videos with attached products directly to the Shop app feed and stores, just like you can manually do from the Shop channel. He was trying to use the mediaCreate mutation, which, according to the documentation, should allow this kind of functionality.

However, instead of a successful response, Ashish kept getting a blunt 410 "api_gone" error. This isn't your typical authentication error or a malformed request; it literally says, "This API has been removed." Talk about a head-scratcher!

He did his due diligence, too. He checked everything – network, credentials (valid, invalid, or none, all returned 410!), and even different routes. Everything pointed to the endpoint itself being gone. Here's the exact curl example he shared, which even came from Shopify's own docs:

curl -X POST https://shop.app/api/partners/graphql.json \
-H 'Content-Type: application/json' \
-u '{CLIENT_ID}:{CLIENT_SECRET}' \
-d '{"query":"{ metafieldDefinitions(first: 5) { edges { node { key } } } }'

And the response:

-> HTTP/2 410  {"message":"api_gone","description":"This API has been removed."}

The kicker? The official Shopify developer documentation still lists mediaCreate, mediaUpdate, and other related operations without any mention of deprecation or removal. This mismatch between live behavior and documentation is exactly what makes these situations so frustrating for developers and store owners alike.

Community Clarifies: Not All Videos Are Created Equal

The community quickly jumped in to help, and some really important distinctions were made. This is where the expertise of folks like Ramadan_Alex and the insights from ai-theme-code-editor really shine.

Product Media vs. Shop Feed Content

The first critical point they clarified is that adding a video to a product via the Admin GraphQL API is NOT the same thing as publishing video content into the Shop feed.

• When you use the Admin GraphQL API to upload a VIDEO or EXTERNAL_VIDEO, you're attaching media directly to a product. This makes it product media, visible on the product page.
• However, this doesn't automatically publish that video as content to the Shop app's main feed, where customers scroll through discoverable content and attached products. Ashish's goal was specifically that Shop feed content.

So, trying to use the Admin GraphQL API as a replacement for the old Shop Partners mediaCreate won't achieve the desired outcome of feeding content into the Shop app's main discovery channels.

Shop Minis: A Different Ballgame

Another avenue explored was Shop Minis. Ashish himself noted that Minis seemed like a different beast, describing them as "more like discord games." The community agreed. While Shop Minis do offer a way to create discoverable content and associate products, it's a completely different integration model with its own eligibility and moderation requirements. It's not a direct API replacement for the simple "post video + attach products" flow for the Shop feed.

So, What's the Path Forward When an API Goes 'Gone'?

Given the definitive 410 api_gone response, the consensus from the community is clear: this isn't a coding error on your end. The API endpoint has been retired. The crucial next step is to get an official answer from Shopify Developer Support. Both ai-theme-code-editor and Ramadan_Alex provided excellent guidance on how to phrase this inquiry to get the most useful response.

How to Escalate to Shopify Developer Support

If you're facing this exact issue, here’s how you should approach Shopify Developer Support:

1. Be Specific About the Problem: Clearly state that the Shop Partners API, specifically the mediaCreate mutation (or any other related mutation you're trying to use), is returning a 410 "api_gone" error.

2. Provide Full Context: Explain your exact goal – to programmatically publish videos to the Shop app/feed with attached products, replicating the manual workflow available through the Shop sales channel.

3. Include Technical Details: Don't forget to include the exact API version you were targeting, the endpoint (e.g., https://shop.app/api/partners/graphql.json), the specific mutation you were attempting (mediaCreate), and any relevant request/response IDs from your failed calls. Ashish provided excellent examples of these in his original post.

4. Ask Direct Questions: Frame your questions precisely to get a definitive answer. Here’s a great template suggested by the community:

   "The Shop channel currently allows merchants to manually publish videos to the Shop app/feed and attach products to those videos. The former Partners mediaCreate mutation is returning 410 api_gone. Is there currently a supported API for programmatically creating/publishing this same type of Shop feed video with attached products? If mediaCreate has been retired, what is its official replacement?"

5. Clarify Availability: Emphasize that you need to know if this capability is still exposed to third-party developers at all, or if it's now intentionally limited to manual operations within the Shop admin. This distinction is vital for planning your development efforts.

The key takeaway here is that you're not trying to fix a bug in your code, but rather seeking clarification on API availability and its official replacement, if one exists. If Shopify confirms there's no public API for this workflow, then it's an API availability limitation, not something you can troubleshoot with code changes.

It's a stark reminder that even with robust platforms like Shopify, API changes can happen, and sometimes the documentation lags. Keeping an eye on community discussions and knowing how to effectively communicate with developer support are invaluable skills for any store owner or developer navigating the ecosystem. Hopefully, Shopify will provide a clear path forward for programmatically managing Shop app feed videos soon!