Creating a personal access token

In order to use the Moderne GraphQL API, you will need to create a Personal Access Token.

info

If you want to learn how to use an access token, please go to the Accessing the Moderne API doc.

In this doc, you can find out:

• How to make a new access token
• How to view what access tokens already exist
• How to revoke access tokens you no longer want
• Some limitations around these access tokens

How to make an access token

1. In the bottom left-hand corner of the app, click on your profile avatar and select Account settings:

2. Click on Access Tokens in the middle of the page:

3. You should now see a page that looks like:

4. In the text box that says Enter token name, enter a descriptive name for your token so that it can easily be distinguished from other tokens.
5. Press the generate button. You should see something that looks like:

Hint: Click the clipboard icon to copy your access token

6. Copy your token to a safe place such as a password manager. You won't be able to see the token again if you close the window.

How to view your access tokens

From the access token page (where you previously created the token), you can see a list of all the tokens:

How to revoke an access token

From the access token page, click Delete icon next to the token you wish to revoke:

Limitations

• Personal access tokens have the lowest level of permissions possible. They do not have the same permissions as your user account. For instance, actions that require a specific role (such as deploying a recipe or uploading an AST) will fail as forbidden if attempted with an access token.