Developer/API changes

API changes explained in plain action steps

For developers and technical operators who need to know what changed, who is affected, what breaks, the deadline or version boundary, and the smallest safe migration step.

Current read

The API pivot is getting relevant impressions but still has not proven click demand. The strongest topic signal remains Shopify returns API, so that page has been upgraded from a short change explainer into a deeper migration guide with a migration map, codebase search checklist, mutation shape, and test matrix.

Use this when: an app, integration, API request, webhook, authentication flow, SDK, or dashboard automation depends on a versioned developer platform.

API change records

ChangeWho is affectedFirst action
Shopify Returns API migration guide: returnProcess, returnRefund, and 2025-07Apps creating returns, approving return requests, processing refunds, or handling exchangesSearch for deprecated return/refund surfaces and migrate return completion to returnProcess
Stripe API versioning: what changes, what breaks, and how to upgrade safelyTeams upgrading Stripe account defaults, SDKs, per-request versions, or webhook endpointsInventory every Stripe version boundary before changing production
Shopify offline access token expires: public app migration by 2027Public apps still using non-expiring offline Admin API tokensMigrate token exchange, refresh handling, and storage before January 1, 2027
Shopify 2026-10 invalid metafield filters return errorsApps filtering products, orders, or customers by metafields in GraphQL Admin API 2026-10+Audit filters and confirm metafield definitions allow filtering before upgrading
GitHub REST API versioning and support windowIntegrations specifying or relying on GitHub REST API versionsSend X-GitHub-Api-Version explicitly and check breaking changes before upgrading

Page format

  1. What changed. The official change in one sentence.
  2. Who is affected. Exact apps, requests, APIs, versions, or flows.
  3. What breaks. The failure mode to look for.
  4. Smallest safe action. The first migration or audit step.
  5. Deeper migration help. Search strings, maps, code shape, and test cases when a page has search signal.
  6. Official sources. Direct links to the platform source.