Workspace Settings
API & CLI Tokens
The API & CLI Tokens page lets you manage authentication tokens for both REST API calls and command-line operations. Tokens grant scoped access to your Experro workspace, enabling integrations, scripts, and automation tools to interact with your data securely.
What You Can Do on This Page
- Switch Between Token Types – Use the API Tokens and CLI Tokens tabs to view and manage each token category separately.
- Review Existing Tokens – See all active tokens you’ve generated, along with metadata like name, description, permission scope, and expiration date.
- Create New Tokens – Click Create Token on the appropriate tab to generate a fresh token for your integrations.
- Copy and Store Tokens Securely – Copy the token value immediately after creation—you won’t be able to view it again. Store it in your secret manager.
- Revoke Tokens – Delete any token that’s no longer needed or that may be compromised to immediately cut off access.
API Tokens Settings
| Field | Description |
|---|---|
| Name | A descriptive label for your token (e.g., “CI/CD Pipeline Token”). Helps you identify its purpose later. |
| Description | A brief note about where or how this token will be used (e.g., “Used by our internal jobs to deploy dashboards”). |
| Permissions | Choose Read Only (view and list operations) or Full Access (create, update, delete). Grant the least privilege needed for your use case. |
| Expiration | Select a calendar date when the token will automatically expire. Shorter lifespans reduce risk so consider rotating tokens every 30–90 days. |
After clicking Save, the token string is shown only once. Copy it immediately and store it in a secure vault.
Creating an API Token
- Navigate to the API Tokens tab and click Create Token.
- Fill in Name, Description, Permissions, and Expiration.
- Click Save.
- Copy the generated token value and store it securely; you cannot retrieve it again later.