Skip to documentation content
HintadataDocs

Invalid Api Key

The request was rejected before the operation was authorized.

In this guide
  1. 1The request was rejected before the operation was authorized.
In this guide
  1. 1The request was rejected before the operation was authorized.

Invalid Api Key

invalid_api_keyauth
Retry: Not before correction

What happened

The request was rejected before the operation was authorized.

Possible causes

  • The credential is missing, expired, revoked, or belongs to another environment.conditional
  • The credential does not contain the required scope or resource binding.conditional

Check in this order

  1. Verify the response evidenceread-only

    Check the environment, credential state, required scope, and resource binding without exposing the credential value.

    error.code · HTTP status · request_id · X-Trace-Id

Safe recovery

Correct the cause before retryingmutation

Use a valid credential with the required least-privilege scope. Do not retry unchanged credentials.

Retry: Not before correction

Success 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-cataloglistConnectedProducts401 · Open API referenceGET/connected-catalog/{productId}getConnectedProduct401 · Open API referenceGET/connected-catalog/{productId}/historygetConnectedProductHistory401 · Open API referenceGET/webhookslistWebhooks401 · Open API referencePOST/webhookscreateWebhook401 · Open API referencePATCH/webhooks/{webhook_id}updateWebhook401 · Open API referenceDELETE/webhooks/{webhook_id}deleteWebhook401 · Open API referencePOST/webhooks/{webhook_id}/secret-rotationprepareWebhookSecretRotation401 · 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-deliverieslistWebhookDeliveries401 · Open API referenceGET/searchsearchProducts401 · Open API referenceGET/comparecompareProducts401 · Open API referenceGET/products/{canonical_product_id}getProductComparison401 · Open API referenceGET/products/{canonical_product_id}/historygetProductPriceHistory401 · Open API referenceGET/watchlistslistPriceWatches401 · Open API referencePOST/watchlistscreatePriceWatch401 · Open API referencePATCH/watchlists/{watch_id}updatePriceWatch401 · Open API referenceDELETE/watchlists/{watch_id}deletePriceWatch401 · Open API referenceGET/pricing/recommendationslistPricingRecommendations401 · Open API referenceGET/assortment/opportunitieslistAssortmentOpportunities401 · Open API referenceGET/sourcing/optionslistSourcingOptions401 · Open API referenceGET/campaigns/signalslistCampaignSignals401 · Open API referencePUT/sources/{source_id}/snapshotputSourceSnapshot401 · Open API referenceGET/webhook-metricsgetWebhookMetrics401 · Open API referenceGET/webhook-auditlistWebhookAudit401 · Open API referencePOST/webhooks/{webhook_id}/testtestWebhook401 · Open API referencePOST/webhook-deliveries/{delivery_id}/retryretryWebhookDelivery401 · Open API referencePUT/merchant/catalogimportMerchantCatalog401 · Open API referenceGET/merchant/coveragegetMerchantCoverage401 · Open API referencePOST/products/resolveresolveProducts401 · Open API referencePOST/offers/batchgetOffersBatch401 · Open API referencePOST/watchlists/batchmanagePriceWatchesBatch401 · Open API reference

Access and surfaces

scope:catalog:readscope:webhooks:writescope:compare:readscope:watchlists:writescope:intelligence:readscope:sources:writescope:merchant:write

Verification evidence

Contractverifiedcontract-derivedSynthetic recoverynot-applicablecontract-derivedRead-only staging canarynot-applicablecontract-derivedProduction observationno-evidencecontract-derived
Was this page helpful?