Skip to content

Commit 4fe41e6

Browse files
docs: add detailed refresh token generation instructions
Add comprehensive guide for generating Last9 refresh tokens: - Admin user scope requirement explained - Step-by-step token generation process - Token expiration and security details - Best practices for token management Based on Last9 API documentation. Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
1 parent 3b2395e commit 4fe41e6

File tree

1 file changed

+29
-4
lines changed

1 file changed

+29
-4
lines changed

README.md

Lines changed: 29 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -99,12 +99,37 @@ jobs:
9999

100100
## Setup
101101

102-
### 1. Get Your Last9 API Token
102+
### 1. Generate a Last9 Refresh Token
103+
104+
**Prerequisites:**
105+
- You must be an **Admin user** in your Last9 organization
106+
- Editors and Viewers cannot generate refresh tokens
107+
108+
**Steps:**
103109

104110
1. Log in to [Last9](https://app.last9.io)
105-
2. Go to **Settings** → **API Access**
106-
3. Create a new **Refresh Token** with **Write** scope
107-
4. Copy the token (you won't be able to see it again!)
111+
2. Navigate to **Settings** → **API Access**
112+
3. Click the **Refresh Token** tab
113+
4. Click **New token**
114+
5. Configure the token:
115+
- **Name**: Enter a descriptive name (e.g., `github-actions-production`)
116+
- **Scope**: Select **Write** (required for sending deployment markers)
117+
6. Click **Create**
118+
7. **Important:** Copy the token immediately - it will only be shown once and cannot be retrieved later
119+
8. Store the token securely (you'll add it to GitHub Secrets in the next step)
120+
121+
**Token Details:**
122+
- Refresh tokens don't expire but can be revoked by admins
123+
- Access tokens generated from refresh tokens expire after **24 hours** (automatically refreshed by this action)
124+
- You can revoke tokens at any time from the API Access page
125+
126+
**Security Best Practices:**
127+
- Use separate tokens for different environments (production, staging, etc.)
128+
- Name tokens clearly to identify their purpose
129+
- Revoke tokens immediately if compromised
130+
- Regularly audit active tokens and remove unused ones
131+
132+
For more information, see the [Last9 API documentation](https://last9.io/docs/getting-started-with-api/).
108133

109134
### 2. Add Token to GitHub Secrets
110135

0 commit comments

Comments
 (0)