Authentication - Esper Docs

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