detektu
Shopify API changes
Info

Setting includeRestOfWorld to true returns an error in API version 2027-01

doc:019fb619-9b4a-74ac-a83e-3ffa98844fb4::feed/https://shopify.dev/changelog/setting-includerestofworld-to-true-returns-an-error-in-api-version-2027-01
Product
Shopify Admin GraphQL API
Source
Feed
Change kind
Feed Entry
Detected
Last updated

Deterministic evidence

Before / after

Extracted from Shopify's published contract. Open the source ↗

−1+81 change

1 / 1
null
{
"content_hash": "1f73c6847d2bc2e354bd05fdfaee231c8b7641bbd8d2f67cc4b9cc938691b876",
"excerpt": "Starting with GraphQL Admin API version 2027-01, setting the deprecated DiscountCountriesInput.includeRestOfWorld field to true returns a BAD_REQUEST error. Apps that use this value must specify every applicable country through add before upgrading. Apps on 2026-10 and earlier keep their existing behavior while those versions are supported. What changed As of API version 2027-01, includeRestOfWorld remains in DiscountCountriesInput, but passing true returns this error: includeRestOfWorld is no l…",
"identity": "https://shopify.dev/changelog/setting-includerestofworld-to-true-returns-an-error-in-api-version-2027-01",
"link": "https://shopify.dev/changelog/setting-includerestofworld-to-true-returns-an-error-in-api-version-2027-01",
"published_at": "2026-09-23T16:00:00Z",
"title": "Setting includeRestOfWorld to true returns an error in API version 2027-01"
}

Interpreted documentation change

What the vendor announced

The evidence describes a change in API behavior starting with GraphQL Admin API version 2027-01: setting DiscountCountriesInput.includeRestOfWorld to true now returns a BAD_REQUEST error, while older versions keep previous behavior. It notes that apps must specify each country individually via add before upgrading, and that includeRestOfWorld remains in the input but true is disallowed in 2027-01. No explicit deprecation notice, rate limit, or replacement endpoint is provided.

Setting includeRestOfWorld to true returns an error in API version 2027-01 Starting with GraphQL Admin API version 2027-01, setting the deprecated DiscountCountriesInput.includeRestOfWorld field to true returns a BAD_REQUEST error. Apps that use this value must specify every applicable country through add before upgrading. Apps on 2026-10 and earlier keep their existing behavior while those versions are supported. What changed As of API version 2027-01, includeRestOfWorld remains in DiscountCountriesInput, but passing true returns this error: includeRestOfWorld is no l…

Vendor source ↗

Monitored for you

Does this change affect your integration?

Choose the operations and fields your services use. Detektu matches Shopify findings to that declared usage so your team can review the relevant evidence. No agent or repository access required.

Monitor Shopify free See pricing

Multi-source correlation

Other Shopify findings correlated with this change across sources.

  1. Deprecation
    SDK version 12.3.0 yankedsdk:npm/@shopify/shopify-api@12.3.0
    Shopify Admin GraphQL API
  2. Potentially breaking
    SDK release 15.0.0sdk:npm/@shopify/shopify-api@15.0.0
    Shopify Admin GraphQL API
  3. Potentially breaking
    SDK release 15.0.0sdk:npm/@shopify/shopify-api@15.0.0
    Shopify Admin GraphQL API