Rate Limited
rate_limitedthrottleWhat happened
The service accepted no more work within the current rate or quota window.
Possible causes
- The caller exceeded the current request rate.conditional
- The workspace quota or credit window is exhausted.conditional
Check in this order
- Verify the response evidenceread-only
Read Retry-After and the rate, quota, and credit response headers before scheduling another attempt.
error.code · HTTP status · request_id · X-Trace-Id · Retry-After
Safe recovery
Retry within the declared budgetreversible
Wait for the declared window and retry with bounded exponential backoff and the same idempotency identity.
Retry: 4 attempts · 600000 msSuccess evidence
- A new response satisfies the documented success contract.
Stop condition
Stop when the retry budget is exhausted or the failure becomes permanent.
Affected API operations
GET/webhookslistWebhooks429 · Open API referencePOST/webhookscreateWebhook429 · Open API referencePATCH/webhooks/{webhook_id}updateWebhook429 · Open API referenceDELETE/webhooks/{webhook_id}deleteWebhook429 · Open API referencePOST/webhooks/{webhook_id}/secret-rotationprepareWebhookSecretRotation429 · Open API referenceGET/webhook-deliverieslistWebhookDeliveries429 · Open API referenceGET/searchsearchProducts429 · Open API referenceGET/comparecompareProducts429 · Open API referenceGET/products/{canonical_product_id}getProductComparison429 · Open API referenceGET/products/{canonical_product_id}/historygetProductPriceHistory429 · Open API referenceGET/watchlistslistPriceWatches429 · Open API referencePOST/watchlistscreatePriceWatch429 · Open API referencePATCH/watchlists/{watch_id}updatePriceWatch429 · Open API referenceDELETE/watchlists/{watch_id}deletePriceWatch429 · Open API referenceGET/pricing/recommendationslistPricingRecommendations429 · Open API referenceGET/assortment/opportunitieslistAssortmentOpportunities429 · Open API referenceGET/sourcing/optionslistSourcingOptions429 · Open API referenceGET/campaigns/signalslistCampaignSignals429 · Open API referencePUT/sources/{source_id}/snapshotputSourceSnapshot429 · Open API referenceGET/webhook-metricsgetWebhookMetrics429 · Open API referenceGET/webhook-auditlistWebhookAudit429 · Open API referencePOST/webhooks/{webhook_id}/testtestWebhook429 · Open API referencePOST/webhook-deliveries/{delivery_id}/retryretryWebhookDelivery429 · Open API referencePUT/merchant/catalogimportMerchantCatalog429 · Open API referenceGET/merchant/coveragegetMerchantCoverage429 · Open API referencePOST/products/resolveresolveProducts429 · Open API referencePOST/offers/batchgetOffersBatch429 · Open API referencePOST/watchlists/batchmanagePriceWatchesBatch429 · Open API referenceAccess and surfaces
scope:webhooks:writescope:catalog:readscope:compare:readscope:watchlists:writescope:intelligence:readscope:sources:writescope:merchant:writepermission:portal:read/dashboard/realtimeVerification evidence
Contractverifiedcontract-derivedSynthetic recoverydeclaredcontract-derivedRead-only staging canarydeclaredcontract-derivedProduction observationno-evidencecontract-derived