EvolveDev Docs

Appearance

🔑 API Token Management ​

API tokens in EvolveDev allow you to build custom integrations, automate workflows, and interact with your EvolveDev data programmatically. These tokens are used to authenticate with the EvolveDev API securely without using your personal login credentials.

This feature is accessible exclusively to users with the Admin role.

⚠️ Security Warning: Treat Tokens Like Passwords ​

An API token provides direct access to your EvolveDev organization's data and settings. Treat your tokens with the same level of security as you would your administrator password. Never share them publicly, commit them to a version control system like Git, or expose them in client-side code.

Accessing the Token Management Page ​

All token-related actions are managed from a dedicated page.

  1. Navigate to Navigation Bar → Admin → Tokens.
  2. On this page, you will see a list of all previously generated tokens (by name) and have the option to create new ones.

Generating a New Token 🚀 ​

  1. From the Tokens page, find the section to create a new token.
  2. Provide a Name: Enter a descriptive name for your token so you can easily identify its purpose later (e.g., "Jenkins CI Script," "BI Dashboard Sync," "Nightly Data Export").
  3. Click the "Generate Token" button.

Important: Save Your Token Immediately! 💾 ​

A popup will appear, displaying your newly generated API token. This is the only time the full token will ever be shown. For your security, EvolveDev does not store the token in a retrievable format.

  • Copy the token immediately.
  • Store it somewhere safe and secure, such as a trusted password manager or a secure vault.

Once you close this popup, you will not be able to see the token again.

Managing and Revoking Tokens 🗑️ ​

If a token is compromised, exposed, or no longer needed, you must delete it immediately to protect your organization's data.

  1. Navigate to the Admin → Tokens page.
  2. Find the token you wish to remove in the list.
  3. Click the "Delete" or "Revoke" button next to the token's name.
  4. Confirm your choice when prompted.

This action is irreversible and will immediately disable the token. Any application or script using this token will no longer be able to access the EvolveDev API.