SDK Keys are keys that you use to integrate with our systems. They are not customer facing.

SDK Keys are secrets. Do not expose them.

SDK Keys are used to authenticate your application with our systems. SDK Keys are not customer facing and should be stored securely in your backend.

The concept of workspace does not apply to SDK Keys. SDK Keys are global and can be used across all workspaces.

Generating SDK Keys

SDK Keys can only be generated using the Dashboard.

SDK Key Scopes

You can associate scopes with the SDK Key to ensure more security.

Definitions

When you create a SDK Key you can configure the following scopes

Scope NameDescription
workspaceAccess to workspace resources
workspace_scopesAccess to workspace scopes
api_keysAccess to API keys

Based on the scope, the SDK key can access certain functionality.

For example, a SDK Key without the api_keys write scope, can not create API keys on the fly.

Considerations

Following are some considerations:

  • SDK Keys can only be generated using our Dashboard.
  • You can assign different scopes to your SDK Keys for the right authorization level.
  • You should store SDK keys securely in your backend.
  • SDK Keys are not publishable keys, they are secret keys that must not be exposed to the public
  • In the event of exposure, revoke them immediately in the dashboard.