Toucan AI Docs
EmbedAuthenticationHow to

Generate a sandbox token

Sandbox tokens in Toucan AI let you test and validate your embedded analytics in a safe, controlled environment—before rolling out to production.

Objective

In this tutorial, you will learn how to generate a sandbox token in Toucan AI. Sandbox tokens allow you to test embedding your visualizations and dashboards in a controlled environment before using them in production.


Prerequisites


Steps

1. Access the Settings Menu

  • From the main interface, click on the Settings button in the menu.

2. Navigate to the Embed Tab

  • In the Settings menu, click on the Embed tab to access token generation settings.

3. Find the Token Generation Sandbox Section

  • Scroll down to the Token Generation Sandbox section within the Embed tab.
  • This section allows you to generate tokens specifically for testing and embedding purposes.

4. Paste Your API Key

  • In the Token Generation Sandbox, you will see a field to paste your API key.
  • Copy your API key (generated in the previous tutorial) and paste it into this field.

5. Generate the Token

  • If needed, complete Custom Attributes to test your Row Level Security
  • After pasting the API key, click the Generate Token button.
  • A sandbox token will be generated and displayed on the screen. This token is valid for a limited time (1 hour by default) and can be used to test embedding visualizations or dashboards.

Token Generation

6. Copy and Store the Token

  • Copy the token to use it for embedding dashboards and testing your integrations.
  • Store the token securely in your password manager for future use.

Conclusion

Congratulations! You have successfully generated a sandbox token in Toucan AI. This token can now be used to test embedding dashboards and charts within your application in a safe environment before going live in production.

Suggested Next Steps: Token Introspection!

On this page