Skip to content

API Keys

Create and manage API keys for programmatic access to Humanbound. Useful for CI/CD pipelines, automation scripts, and integrations.

List API Keys

hb api-keys list

Create API Key

# Create key (shows key once!)
hb api-keys create --name "CI Key"

# Create scoped key
hb api-keys create --name "CI Key" --scopes read

Important

API keys are shown only once during creation. Store them securely. If lost, you must revoke and create a new key.

Update API Key

# Update name
hb api-keys update <id> --name "New Name"

# Activate key
hb api-keys update <id> --active

# Deactivate key
hb api-keys update <id> --inactive

Revoke API Key

# Revoke with confirmation
hb api-keys revoke <id>

# Skip confirmation
hb api-keys revoke <id> --force

Scopes

  • admin: Full access including user management and sensitive operations
  • write: Create and modify projects, run tests, update findings
  • read: View-only access to projects, experiments, and results