Profiles

Profiles let you keep multiple (API key, pixel id) configurations side-by-side — e.g. one for production and one for staging, or one per client.

Create a profile

upstack init --profile staging
upstack init --profile client-b

Use a profile

Pass --profile <name> on any command. Without --profile, the default profile is used.

upstack --profile staging query --measures revenue \
  --date-start 2026-04-01 --date-end 2026-04-30

upstack whoami --profile staging

List profiles

upstack profiles

Prints all configured profile names.

Remove a profile

upstack logout --profile staging

Removes credentials for the named profile from ~/.upstackrc. If it was the last profile, the file is deleted.

Storage

All profiles live in ~/.upstackrc (mode 0600) under a profiles map:

{
  "profiles": {
    "default": { "baseUrl": "...", "apiKey": "upstack_...", "pixelId": "..." },
    "staging": { "baseUrl": "...", "apiKey": "upstack_...", "pixelId": "..." }
  }
}

⌘I

GETTING STARTED

ACCOUNT

DISCOVERY

QUERIES

DASHBOARDS

COSTS

PRODUCTS

ADVANCED

Create a profile

Use a profile

List profiles

Remove a profile

Storage

​Create a profile

​Use a profile

​List profiles

​Remove a profile

​Storage

Create a profile

Use a profile

List profiles

Remove a profile

Storage