Skip to main content

CLI Authentication

Authenticate the CLI to interact with your SureStage account.

Interactive Login​

surestage auth login

This opens your browser for OAuth authentication. After authorizing, the CLI stores your credentials securely.

API Key Authentication​

For CI/CD and non-interactive environments:

surestage auth login --api-key YOUR_API_KEY

Or set the environment variable:

export SURESTAGE_API_KEY=your_api_key_here

Token Management​

# Check current auth status
surestage auth status

# Refresh an expired token
surestage auth refresh

# Log out and clear credentials
surestage auth logout

Switching Tenants​

If you belong to multiple organizations:

# List available tenants
surestage auth tenants

# Switch to a different tenant
surestage auth switch-tenant <tenant-slug>

Next Steps​