Invalid Request
invalid_requeststateWhat happened
The resource is not in the state required by the requested operation.
Possible causes
- Asynchronous work is still in progress.conditional
- The job or export reached a terminal failed state.conditional
Check in this order
- Verify the response evidenceread-only
Read the owned resource status and failure evidence before taking another action.
error.code · HTTP status · request_id · X-Trace-Id
Safe recovery
Correct the cause before retryingmutation
Poll only until the declared terminal state. Recreate or retry work only when the failure classification permits it.
Retry: Not before correctionSuccess evidence
- A new response satisfies the documented success contract.
Stop condition
Do not retry until the diagnostic check identifies a corrected input or configuration.
Affected API operations
GET/connected-cataloglistConnectedProducts400 · Open API referenceGET/connected-catalog/{productId}getConnectedProduct400 · Open API referenceGET/connected-catalog/{productId}/historygetConnectedProductHistory400 · Open API referenceGET/webhookslistWebhooks400 · Open API referencePOST/webhookscreateWebhook400 · Open API referencePATCH/webhooks/{webhook_id}updateWebhook400 · Open API referenceDELETE/webhooks/{webhook_id}deleteWebhook400 · Open API referencePOST/webhooks/{webhook_id}/secret-rotationprepareWebhookSecretRotation400 · Open API referencePOST/webhooks/{webhook_id}/secret-rotation/activateactivateWebhookSecretRotationdefault · Open API referencePOST/webhooks/{webhook_id}/secret-rotation/cancelcancelWebhookSecretRotationdefault · Open API referencePOST/webhooks/{webhook_id}/incidents/acknowledgeacknowledgeWebhookIncidentdefault · Open API referenceGET/webhook-deliverieslistWebhookDeliveries400 · Open API referenceGET/searchsearchProducts400 · Open API referenceGET/comparecompareProducts400 · Open API referenceGET/products/{canonical_product_id}getProductComparison400 · Open API referenceGET/products/{canonical_product_id}/historygetProductPriceHistory400 · Open API referenceGET/watchlistslistPriceWatches400 · Open API referencePOST/watchlistscreatePriceWatch400 · Open API referencePATCH/watchlists/{watch_id}updatePriceWatch400 · Open API referenceDELETE/watchlists/{watch_id}deletePriceWatch400 · Open API referenceGET/pricing/recommendationslistPricingRecommendations400 · Open API referenceGET/assortment/opportunitieslistAssortmentOpportunities400 · Open API referenceGET/sourcing/optionslistSourcingOptions400 · Open API referenceGET/campaigns/signalslistCampaignSignals400 · Open API referencePUT/sources/{source_id}/snapshotputSourceSnapshot400 · Open API referenceGET/webhook-metricsgetWebhookMetrics400 · Open API referenceGET/webhook-auditlistWebhookAudit400 · Open API referencePOST/webhooks/{webhook_id}/testtestWebhook400 · Open API referencePOST/webhook-deliveries/{delivery_id}/retryretryWebhookDelivery400 · Open API referencePUT/merchant/catalogimportMerchantCatalog400 · Open API referenceGET/merchant/coveragegetMerchantCoverage400 · Open API referencePOST/products/resolveresolveProducts400 · Open API referencePOST/offers/batchgetOffersBatch400 · Open API referencePOST/watchlists/batchmanagePriceWatchesBatch400 · Open API referenceAccess and surfaces
scope:catalog:readscope:webhooks:writescope:compare:readscope:watchlists:writescope:intelligence:readscope:sources:writescope:merchant:writeVerification evidence
Contractverifiedcontract-derivedSynthetic recoverynot-applicablecontract-derivedRead-only staging canarynot-applicablecontract-derivedProduction observationno-evidencecontract-derived