Manage personal access tokens

View personal access tokens

To view your personal access tokens, dates when they were created, and when they expire:

  1. Log in to Cloud Manager

  2. Click your username in the top corner of the screen and select API Tokens under the My Profile section.

    A screenshot of the API tokens option within the username menu.

This displays the API Tokens tab on the My Profile page.

A screenshot of the API Tokens tab showing a Personal Access Token section with the Create A Personal Access Token button and a table with the following fields: Label, Created, Expires and the following buttons: View Scopes, Rename, Revoke.

Create an API token

Whenever you need to authorize API access to an application or service, you should create a new personal access token. This token should only allow the level of access needed by the application.

  1. Log in to Cloud Manager.

  2. Click your username at the top of the screen and select API Tokens

  3. Click Create a Personal Access Token.

  4. In the Add Personal Access Token window:

    1. Enter a Label for the token to identify it and understand its intended use in the future.

    2. Select the Expiry time for the token.

    3. For each product or service on the list, select the level of access the token should have.

      A screenshot of the Add Personal Access Token window showing products and services, and three access options: No Access, Read Only, Read Write.

    4. Click Create Token.

    The token is displayed in the pop-up. Save the token in a safe place, such as a password manager.

🚧

After closing this pop-up, you won't be able to view the token again.

A screenshot of the Personal Access Token pop-up showing the Personal Access Token with the download and copy icons and the I Have Saved My Personal Access Token button.

Revoke a personal access token

If you wish to decommission a token or think it may have been compromised, you can revoke access. Once revoked, any application using this token will no longer be authorized to access your account through the Linode API.

  1. Log in to Cloud Manager and navigate to the API Tokens page of the My Profile section. See View Personal Access Tokens.

  2. Find the token you wish to revoke and click the corresponding Revoke button, which may be visible within the more options ellipsis menu.

    A screenshot showing the Revoke button within the table.

  3. A pop-up appears asking you to confirm that you wish to revoke this token. Click the Revoke button to delete the token and revoke access to any application using that token.