Permissions (Scopes)
Each Access Token either has:- No Access.
- Full Access to Resources and APIs which the token owner also has access to.
Expiration
All Access Tokens have an expiration time. When a token expires, requests made with the token will fail with Unauthorized. When a token expires, you can regenerate it.Managing Access Tokens
Listing Access Tokens
You can list your Access Tokens in your user Settings, or by going to gitpod.io/tokens.Creating an Access Token
You can create an Access Token by navigating to gitpod.io/tokens or through Settings > Access Tokens. Clicking New Access Token will prompt you to specify details of the token.- Your access tokens will automatically expire after the specified duration.
- Once you create an Access Token, it will be shown to you once. Make sure you store it in a secure place, you will not be able to retrieve it again.
Updating an Access Token
Access Token can be updated. You can update the following properties on a token:- Name
- Permission scopes
Regenerating Access Tokens
Access Token can be regenerated. Regenerating a token will:- Create a new token secret, which you’ll need to store in a secure place and replace your old one.
- The new token will have a new expiration time.
- The old token will no longer be valid and will receive Unauthorized when interacting with APIs.