Troubleshooting Guide
Having issues with the SDK? Use the resources below to quickly diagnose and resolve common problems.
Symptom: npm install returns errors about missing peer dependencies.
Solution: Run npm install --legacy-peer-deps or update your project's package.json to match the SDK's peer requirements. See the Installation guide for details.
Symptom: API calls return 401 Unauthorized.
Solution: Verify that your API key is set correctly in the environment variable SDK_API_KEY and that the key has the required scopes. Use the button to copy a working config snippet.
Symptom: The application crashes with a segmentation fault after invoking sdk.init().
Solution: Ensure you are using a supported version of the underlying runtime (Node >=14). Update your runtime and rebuild native modules with npm rebuild. If the issue persists, enable debug logging by setting SDK_DEBUG=1.
Symptom: API responses take longer than expected.
Solution: Enable request batching and enable caching. See the API Reference for configuration details.
Need More Help?
Visit our Community Forum or file an issue on GitHub.