Skip to main content

SDK-001

Invalid SDK key

The SDK key is missing, invalid, or was rejected by the ingest endpoint.

What the SDK does

Initialization stops for a missing key or an API Token. An HTTP 401 or 403 from ingest disables reporting for that SDK instance.

What to check

  1. Use an SDK Key

    Open Settings → Credentials → SDK Keys. Use the project’s cup_sdk_ credential. A cup_api_ API Token is a server-side secret and cannot be used as an SDK Key.

  2. Check the deployed configuration

    Confirm that sdkKey receives the intended value in the environment where the error occurs. If the key was revoked, replace it. Never include the full key in a support message.

  3. Restart after correcting the key

    Restart the application or reload the browser so the SDK initializes with the replacement. If an API Token was exposed in browser code or logs, revoke it.

SDK Keys and API Tokens

Still seeing the error?

Send the code, SDK version, runtime and a redacted error message. Keep credentials and customer data out of the report.

Email SDK support