Generating an API Token

How to generate an API token in RiskSense.

In order to use the RiskSense API, you will need an API authorization token. Authorization tokens are generated in the RiskSense platform. Permissions to access RiskSense platform data are based on the permissions of the RiskSense user that generates the token. The following steps will show you how to generate and manage RiskSense API tokens.

To generate an API token, click your initials in the page’s top-right corner. In this menu, click User Settings.

User Settings Menu Location

Once on the User Settings page, scroll down to the API Tokens section. This is where you generate new tokens to use the RiskSense API. If you have already created API tokens in the past, their names are displayed here. You can rename or delete existing API tokens here, as well.

API Token - User Settings

To generate a new token, click the blue Generate button in the API Tokens section.

API Token - Generate Token Button

When you click the Generate button, the following dialog box appears.

API Token - Name API Token Window

Token names may not contain spaces but may contain all alphanumeric characters and the following special characters:

^ \ - , + $

After entering your token name, click Generate. RiskSense displays the following dialog box showing the newly generated API token.

API Token - New API Token Window

This token will only be displayed once. Select and copy the API token to a secure location, so you can retrieve it later. Clicking the Clipboard icon to the right of the API token also copies the token to the clipboard, as well.

After copying the new token, click OK to return to the User Settings page. This token can now be used to interact with the RiskSense REST API.