Below, we’ll overview the process of personal access tokens management using the dashboard UI:
1. Go to the Settings
section by clicking on the same-named button at the top-right corner of the dashboard.
2. In the opened frame, select the Access Tokens
tab to view the list of all tokens on the account. The tools panel above the list provides access to the following buttons:
- Generate - creates a new token by providing the description, expiration date and selecting the required API methods (either from predefined sets or manually)
- Edit - adjusts the existing token or regenerates it (i.e. sets a new name, while maintaining all other parameters)
- Copy - creates a new token using parameters of the existing one as a basis
- Remove - deletes selected token
- Refresh - displays the most recent changes to the list
3. While creating a new or adjusting the existing token, the following frame is displayed, allowing to adjust:
- Description - custom description provided for token
- Expires At - the date in the dd-mm-yyyy format this token is valid till (can be regenerated after expiration)
- API - the name of the API requests set: predefined (Extended Access, IDE Plugins, Marketplace, Maven Plugin) or Custom (with manually selected methods)
- use the Search field, the Only Checked filter and links to the API Docs (displayed upon hovering over the particular method) to configure required permissions for token
4. All the token changes on account require an obligatory confirmation with the password before being applied.
5. Next, you’ll see the access token value. Ensure you’ve saved it (use the Download
buttons), as it won’t be displayed anywhere ever again.
If you forget or lost your token value, it is possible to generate a new one by accessing the Edit Access Token
frame and clicking the appropriate link at the bottom.
Herewith, the old value becomes invalid, so any existing automation with this token should be updated.
6. You can Remove
no longer required tokens (use Shift
to select multiple ones) with the same-named button at the tools panel.
Confirm in a pop-up and provide the password to proceed.
Now, you know how to manage personal access tokens on the account and can use them in your API requests.