Skip to content
QubitHub QubitHub Docs

Authentication

API keys

Section titled “API keys”

Create an API key via the CLI (name is a positional argument):

Terminal window
qubithub keys create my-key
qubithub keys create my-key --scopes "circuit:read,circuit:write"

Use it in requests via the X-API-Key header:

Terminal window
curl -H "X-API-Key: qh_..." https://qubithub.co/api/circuits

CLI authentication

Section titled “CLI authentication”
Terminal window
qubithub login                       # Interactive email/password prompt
qubithub login --api-key qh_abc123   # Non-interactive API key auth
qubithub login --token eyJhbG...     # Non-interactive JWT auth

Verify you’re authenticated:

Terminal window
qubithub whoami

Rate limits

Section titled “Rate limits”
TierRate Limit
Free60 req/min
Pro600 req/min

Security best practices

Section titled “Security best practices”
  • Never commit API keys to version control
  • Use environment variables for CI/CD workflows (QUBITHUB_API_KEY)
  • Rotate keys periodically via qubithub keys revoke <key-id>