PatchVault › Errors › Shopify CLI 5 migration
The REST Admin API is a legacy API as of October 1, 2024. Starting April 1, 2025, all new public apps must be built exclusively with the GraphQL Admin API.
Your app still calls /admin/api/<version>/*.json REST endpoints. Shopify marked the REST Admin API legacy and requires new public App Store submissions to use GraphQL only.
Check your code free (runs in your browser)
The box is pre-filled with a sample that triggers this error. Paste your own file to check it. Nothing leaves this page.
Or scan your whole repo locally (free, stdlib Python, read-only):
python3 <(curl -fsSL https://patchvault-81y.pages.dev/starters/shopify-cli-scan.py) .
Get the Shopify CLI 5 migration auto-fixer: $9 one-time
Why it happens
Shopify's October 1, 2024 changelog made GraphQL the primary Admin API. Separately, all public apps had to move to the new GraphQL Product APIs by February 1, 2025.
Manual fix
// before (REST)
await fetch(`https://${shop}/admin/api/2024-01/products.json`, { headers })
// after (GraphQL)
await admin.graphql(`#graphql
query { products(first: 10) { nodes { id title } } }`)
Verify
Re-run your install/build and re-scan the file above. The finding should be gone. The paid fixer applies the same change across a repo: --dry-run shows the diff, --apply keeps a .bak of each file, and --rollback restores them.
Sources
- Shopify changelog: new public apps must use GraphQL (Oct 1, 2024)
- Shopify REST Admin API reference (legacy notice)
- Shopify changelog: new GraphQL Product APIs required for public apps
Related errors
- shopify theme dev --poll removed in Shopify CLI 5.0
- shopify app logs / app logs sources removed in CLI 5.0
- SHOPIFY_CLI_PARTNERS_TOKEN → SHOPIFY_SERVICE_ACCOUNT_TOKEN
- shopify theme list --json: jq "Cannot index object"
- shopify.app.toml auditor: client_id, [access_scopes] and [webhooks] api_version
Full guide and free terminal scanner: Shopify CLI 5 migration. Last checked 2026-10-31.