Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.upstackdata.com/llms.txt

Use this file to discover all available pages before exploring further.

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": "..." }
  }
}