Profiles

Switch between API keys, pixels, and environments using named 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, marking the active one with (active).

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. There is no environment-specific URL — the API base URL is baked into the CLI build:

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

upstack init and upstack whoami print the API key masked (***** followed by the last 5 characters).