Help us improve
Share bugs, ideas, or general feedback.
From shopify-commerce
Provides deprecated Shopify REST Admin API reference—endpoints, auth, rate limits—and GraphQL migration mappings. Use for legacy maintenance or migration planning.
npx claudepluginhub orcaqubits/agentic-commerce-skills-plugins --plugin shopify-commerceHow this skill is triggered — by the user, by Claude, or both
Slash command
/shopify-commerce:shopify-api-restThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
> **DEPRECATION NOTICE:** The Shopify REST Admin API was deprecated in October 2024. All new development MUST use the GraphQL Admin API. This skill exists for maintaining legacy code and planning migration.
Use Shopify GraphQL Admin API for server CRUD on products/orders and Storefront API for client queries on products/cart, with versioning, rate limits, bulk ops, pagination.
Upgrades Shopify API versions quarterly, migrates REST to GraphQL Admin API, and reviews breaking changes like ProductInput splits.
Writes or explains Shopify Admin GraphQL queries and mutations for apps and integrations extending the admin. Use for understanding, designing, or generating operations before execution or config validation.
Share bugs, ideas, or general feedback.
DEPRECATION NOTICE: The Shopify REST Admin API was deprecated in October 2024. All new development MUST use the GraphQL Admin API. This skill exists for maintaining legacy code and planning migration.
Fetch live docs:
site:shopify.dev rest admin api deprecation for deprecation timelinesite:shopify.dev migrate rest to graphql for migration guidehttps://shopify.dev/docs/api/admin-rest for REST reference (if maintaining legacy code)https://{store}.myshopify.com/admin/api/{version}/products.json, orders.json, customers.json, etc.X-Shopify-Access-Token: {token}X-Shopify-Shop-Api-Call-Limit: 32/40Link header (not page numbers)rel="next" and rel="previous" links| REST Endpoint | GraphQL Equivalent |
|---|---|
GET /products.json | query { products(first: 50) { edges { node { ... } } } } |
POST /products.json | mutation { productCreate(input: {...}) { ... } } |
PUT /products/{id}.json | mutation { productUpdate(input: {...}) { ... } } |
DELETE /products/{id}.json | mutation { productDelete(input: {id: "..."}) { ... } } |
GET /orders.json | query { orders(first: 50) { edges { node { ... } } } } |
GET /customers.json | query { customers(first: 50) { edges { node { ... } } } } |
| Aspect | REST | GraphQL |
|---|---|---|
| Data shape | Fixed response | Client-defined |
| Rate limiting | Request count (40/s) | Cost-based (1000 points) |
| Pagination | Link headers | Cursor arguments |
| Bulk operations | Not available | bulkOperationRunQuery |
| Webhooks | REST endpoint | Same (subscription via GraphQL) |
| ID format | Numeric (12345) | GID (gid://shopify/Product/12345) |
REST uses numeric IDs; GraphQL uses Global IDs (GIDs):
12345gid://shopify/Product/12345gid://shopify/{ResourceType}/userErrors, not HTTP status codesFetch the Shopify REST-to-GraphQL migration guide for exact endpoint mappings and timeline before planning a migration.