Create a Token
1
Open API Tokens
Go to Settings > API Tokens and click Create token.
2
Name the Token
Enter a name you’ll recognize, such as
CI deploys. Use up to 64 letters, digits, spaces, -, _ and ..3
Choose the Access
- Read only: view servers, SSH keys, invoices and the catalog.
- Read & write: also create, change, power, reinstall, resize and delete servers. Creating and resizing servers charges your default card.
4
Choose When It Expires
Pick Never, 30 days, 90 days or 1 year from the Expires menu. It starts on Never.
5
Copy the Token
Click Create token, copy the token, then click Done. It starts with
arct_.Token Created Email
Each time a token is created, we email the account owner. The email shows the token’s name, access, expiry, when it was created (in UTC) and the IP address it was created from. It never contains the token itself. If you didn’t create the token, delete it in Settings > API Tokens and change your password.View Your Tokens
Settings > API Tokens lists each token with:- its name, with the first 12 characters of the token under it;
- its Access: Read only or Read & write, both in the same gray badge;
- an Enabled switch;
- when it Expires;
- when it was Last used (updated at most once a minute);
- when it was Created.
Turn a Token Off or On
Use the Enabled switch next to a token. A token that is off stops working right away, and turning it back on restores it. This is useful to check that nothing still uses a token before you delete it.Rename a Token
Click Rename next to the token, enter the new name, and click Save.Delete a Token
- Click Delete next to the token
- Click Delete token in the dialog