Page tree

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space DEV and version r094


API access tokens are enabled by default.

Enable individual access

When access tokens are enabled, by default only administrators are permitted to generate tokens. Optionally, workspace administrators can enable individual users in the workspace to generate and use their own API access tokens. For more information, see Workspace Settings Page.

Generate New Token

API access tokens must be created. 

Via UI

Tokens can be generated from the web application.


  1. Login to the 
    D s webapp
  2. From the left nav bar, select User menu > Preferences > Access Tokens.
  3. Click Generate New Token.
  4. Specify the number of days for how long the token should live.




    Tip: Depending on how your environment is configured, you may be able to enter -1 to create a non-expiring token.

  5. Add a user-friendly description if desired.
  6. Click Generate.

NOTE: Copy the value of the token to the clipboard and store it in a secure location for use with your scripts. For security reasons, the token value itself cannot be retrieved from the application after it has been created.

For more information, see Access Tokens Page.



NOTE: API access tokens are not used by users in through the

D s webapp

After you have acquired the token, you submit it with each API request to the platform.

Example - cURL: 

The following example returns a JSON version of the list of available REST API endpoints for your environment:

Code Block
curl http://<my_workspace_name>


open-api-spec -X GET -H "Authorization: Bearer (tokenValue)"

  • <my_workspace_name> is the name of the workspace from which the token was issued.


  • Via UI: In the Access Tokens page, select Delete Token... from the context menu for the token listing. See Access Tokens Page.

D s also