Idempotency Conflict
idempotency_conflictinputWhat happened
The request does not satisfy the operation contract or conflicts with an earlier request.
Possible causes
- A required field, format, range, or idempotency value is invalid.conditional
- The request body was built against a different contract version.conditional
Check in this order
- Verify the response evidenceread-only
Compare the request with the current schema and inspect the structured validation issues.
error.code · HTTP status · request_id · X-Trace-Id
Safe recovery
Correct the cause before retryingmutation
Correct only the rejected fields, preserve the intended idempotency identity, and submit a new validated request.
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/webhookslistWebhooks409 · Open API referencePOST/webhookscreateWebhook409 · Open API referencePATCH/webhooks/{webhook_id}updateWebhook409 · Open API referenceDELETE/webhooks/{webhook_id}deleteWebhook409 · Open API referencePOST/webhooks/{webhook_id}/secret-rotationprepareWebhookSecretRotation409 · 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-deliverieslistWebhookDeliveries409 · Open API referenceGET/searchsearchProducts409 · Open API referenceGET/comparecompareProducts409 · Open API referenceGET/products/{canonical_product_id}getProductComparison409 · Open API referenceGET/products/{canonical_product_id}/historygetProductPriceHistory409 · Open API referenceGET/watchlistslistPriceWatches409 · Open API referencePOST/watchlistscreatePriceWatch409 · Open API referencePATCH/watchlists/{watch_id}updatePriceWatch409 · Open API referenceDELETE/watchlists/{watch_id}deletePriceWatch409 · Open API referenceGET/pricing/recommendationslistPricingRecommendations409 · Open API referenceGET/assortment/opportunitieslistAssortmentOpportunities409 · Open API referenceGET/sourcing/optionslistSourcingOptions409 · Open API referenceGET/campaigns/signalslistCampaignSignals409 · Open API referencePUT/sources/{source_id}/snapshotputSourceSnapshot409 · Open API referenceGET/webhook-metricsgetWebhookMetrics409 · Open API referenceGET/webhook-auditlistWebhookAudit409 · Open API referencePOST/webhooks/{webhook_id}/testtestWebhook409 · Open API referencePOST/webhook-deliveries/{delivery_id}/retryretryWebhookDelivery409 · Open API referencePUT/merchant/catalogimportMerchantCatalog409 · Open API referenceGET/merchant/coveragegetMerchantCoverage409 · Open API referencePOST/products/resolveresolveProducts409 · Open API referencePOST/offers/batchgetOffersBatch409 · Open API referencePOST/watchlists/batchmanagePriceWatchesBatch409 · Open API referenceAccess and surfaces
scope:webhooks:writescope:catalog:readscope:compare:readscope:watchlists:writescope:intelligence:readscope:sources:writescope:merchant:writeVerification evidence
Contractverifiedcontract-derivedSynthetic recoverynot-applicablecontract-derivedRead-only staging canarynot-applicablecontract-derivedProduction observationno-evidencecontract-derived