Auth Commands
Manage Bootspring authentication and API keys.
Synopsis
Loading code block...
Commands
| Command | Description |
|---|---|
login | Authenticate with Bootspring |
logout | Log out and clear credentials |
status | Check authentication status |
token | Display or refresh API token |
bootspring auth login
Authenticate with your Bootspring account.
Usage
Loading code block...
Options
| Option | Description |
|---|---|
--key <key> | Provide API key directly |
--browser | Open browser for OAuth login |
Examples
Loading code block...
Output:
Bootspring Authentication
═══════════════════════════════════════════════════════════════════
Opening browser for device login...
Visit this URL if the browser doesn't open:
https://bootspring.com/auth/cli
Waiting for authorization...
✓ Authenticated successfully
Account: john@example.com
Tier: Founder
Loading code block...
Browser login flow:
Opening browser for authentication...
Visit this URL if browser doesn't open:
https://bootspring.com/auth/cli?token=abc123
Waiting for authentication...
✓ Authenticated successfully
bootspring auth logout
Log out and remove stored credentials.
Usage
Loading code block...
Options
| Option | Description |
|---|---|
--all | Log out from all devices |
Example
Loading code block...
Output:
Logged out successfully
Credentials removed from: ~/.bootspring/credentials
bootspring auth status
Check current authentication status.
Usage
Loading code block...
Options
| Option | Description |
|---|---|
--json | Output as JSON |
Example
Loading code block...
Output (authenticated):
Authentication Status
═══════════════════════════════════════════════════════════════════
Status: Authenticated ✓
Account: john@example.com
Tier: Pro
Devices: 3/5 used
API Usage This Month
────────────────────
Calls: 4,521 / 10,000 (45%)
Reset: April 1, 2024
Output (not authenticated):
Authentication Status
═══════════════════════════════════════════════════════════════════
Status: Not authenticated
Log in with: bootspring auth login
bootspring auth token
Display or refresh the API token.
Usage
Loading code block...
Options
| Option | Description |
|---|---|
--show | Display the current token |
--refresh | Refresh the token |
--copy | Copy token to clipboard |
Examples
Loading code block...
Output:
API Token
═══════════════════════════════════════════════════════════════════
Token: bsk_************************4f3a
Type: Pro
Valid: Yes
Use --show to display full token
Loading code block...
Output:
API Token
═══════════════════════════════════════════════════════════════════
Token: bsk_live_1234567890abcdef1234567890abcdef4f3a
⚠️ Keep this token secret! Don't share or commit to version control.
Loading code block...
API Key Management
Getting an API Key
The CLI happy path is bootspring auth login (device authorization) — it works on every plan, including Free and Founder. Manual API keys are optional integration credentials on plans that include them.
- Visit https://bootspring.com/dashboard/keys
- If your plan includes keys, click "New Key"
- Copy and save your key securely
- Or skip keys entirely and use
bootspring auth login
Key Types
| Type | Usage | Permissions |
|---|---|---|
| Development | Local development | Full access |
| CI/CD | Automated pipelines | Quality checks only |
| Read-only | Documentation access | Read context only |
Storing Keys
Keys are stored in ~/.bootspring/credentials:
Loading code block...
Or use environment variable:
Loading code block...
Security Best Practices
DO
- Store keys in environment variables
- Use CI/CD-specific keys for pipelines
- Rotate keys periodically
- Use read-only keys when possible
DON'T
- Commit keys to version control
- Share keys with others
- Use production keys in development
- Store keys in plain text files in project
Revoking Keys
If a key is compromised:
- Go to https://bootspring.com/dashboard/api-keys
- Find the compromised key
- Click "Revoke"
- Generate a new key
Troubleshooting
Invalid API Key
Error: Invalid API key
Solutions:
- Verify key is correct
- Check key hasn't been revoked
- Ensure key has required permissions
Expired Session
Error: Session expired
Solutions:
- Run
bootspring auth loginagain - Check account status at dashboard
Rate Limited
Error: Rate limit exceeded
Solutions:
- Wait for rate limit reset
- Check usage at dashboard
- Consider upgrading tier
Related
- Tiers and Limits - Tier information
- Dashboard Guide - Managing account
- Security - Security best practices