API Authentication

Getting an access token

1. Sign into SaturnCI
2. Click on your name in the top right
3. Click "Personal Access Tokens"
4. Click "Generate personal access token"
5. Copy the token

Getting your user ID

1. Sign into SaturnCI
2. Click on your name in the top right
3. Copy your user ID

Using your access token

Example:

curl -u USER_ID:PERSONAL_ACCESS_TOKEN https://app.saturnci.com/api/v1/test_suite_runs

Storing your credentials

You can store your credentials in ~/.saturnci/credentials.json:

{
  "user_id": "your-user-id",
  "api_token": "your-personal-access-token"
}

The SaturnCI CLI reads credentials from this file automatically.