GraphQL Admin API - example Throttled request's response

Topic summary

Focus: What a throttled Shopify Admin GraphQL API response looks like, including status code and JSON structure.

Key details provided:

  • Body example: errors contains a single item with message “Throttled”. extensions includes cost with requestedQueryCost, actualQueryCost (null when throttled), and throttleStatus (maximumAvailable, currentlyAvailable, restoreRate).
  • Structure clarification: errors, data, and extensions are top-level fields. When throttled, data is absent (or null); only errors and extensions appear.

Status code:

  • One reply states the HTTP status is 429. The original question notes REST docs confirm 429, but GraphQL docs don’t explicitly say so. No authoritative confirmation was posted, but 429 is suggested.

Documentation discrepancy:

  • A participant confirms extensions is not nested inside errors, contrary to the current docs; they assert the docs are wrong and provide a non-throttle error example showing top-level fields.

Open items:

  • A user experiencing throttling when adding product images requested help; no troubleshooting steps were provided.
  • Definitive, documented confirmation of the GraphQL HTTP status code remains unresolved.
Summarized with AI on December 18. AI used: gpt-5.

For sure it’s 429 for Admin REST API, but the documentation doesn’t mention if it’s true for GraphQL API too. Thanks anyway @AddisonApps :slight_smile: