Skip to main content

​
API key flow

For most CLI and hybrid runtime usage, initialize the workspace with a tenant-scoped API key: 
esper init \
  --api-base https://api.esperr.com \
  --api-key <secret> \
  --tenant-id <tenant-id>
The CLI sends configured API keys with x-esper-api-key. When api_key is set in ~/.esper/config.yaml, it takes precedence over stored operator-token credentials.

​
Hosted token flow

Use hosted token login when you need an operator session, such as listing keys for a tenant: 
esper auth login --token <jwt>
esper auth whoami
esper keys list

​
Checking authentication

Verify the current stored token or configured API key: 
esper auth whoami

​
Logout

Clear stored credentials: 
esper auth logout