​

API Tokens

​

Creating a Token

1. Go to app.dotsetlabs.com
2. Open your project
3. Click the API Tokens tab
4. Click New Token
5. Name your token (e.g., “CI Pipeline”, “Local Dev”)
6. Copy the token immediately — it won’t be shown again

​

Token Format

dss_<random-48-chars>

​

Using Tokens

​

Link a Project

dotset link <project-id> --token dss_xxxxx

​

In CI/CD

# GitHub Actions
env:
  DOTSET_TOKEN: ${{ secrets.DOTSET_TOKEN }}

steps:
  - run: dotset link ${{ vars.PROJECT_ID }} --token $DOTSET_TOKEN
  - run: dotset run --mode redact -- npm test

​

Token Limits by Plan

​

Revoking Tokens

1. Go to your project’s API Tokens tab
2. Click the trash icon next to the token
3. Confirm deletion

​

Security Best Practices

• Use different tokens for dev and CI
• Rotate tokens periodically
• Never commit tokens to git
• Use environment variables in CI