Create a token
- Go to Personal access tokens
- Click “New Token”
- Enter a description and select expiration (30, 60, or 90 days)
- Choose an access level:
- Read-only - the token can only read data. All write operations are denied.
- Read & Write - the token can both read and modify data.
- Click “Create” and copy the token immediately - you won’t see it again
Use a token
Permissions
Tokens inherit your user account’s permissions and can be scoped to one of two access levels:
The access level is set at creation time and cannot be changed afterward. To switch access levels, revoke the existing token and create a new one.
Security
- Treat tokens like passwords - don’t share or store insecurely
- Use the shortest expiration that meets your needs
- Revoke unused tokens
- Actions are logged in audit logs with the token ID