Skip to content
Authentication

API Keys

Token-based authentication for CI/CD pipelines, headless environments and programmatic access — no browser required.

Lurus Code Dashboard — Create new API key dialog

One-Click Creation

Generate a new API key from the dashboard with a custom name and optional expiration — the full key is shown only once.

SHA-256 Hash Storage

Keys are hashed with SHA-256 before being stored. The plaintext key never touches the database.

Flexible Expiration

Choose from 7 days, 30 days, 90 days, 1 year, or no expiration at all. Revoked and expired keys are automatically purged after 90 days.

Instant Revocation

Revoke any key instantly from the dashboard. Revoked keys stop working immediately across all environments.

Audit Trail

Key creation and revocation are logged with IP, user-agent and timestamp. First usage is tracked automatically.

Email Notifications

Receive an email notification whenever a new API key is created on your account — with IP and device details.

How It Works

1

Create a Key

Open Settings in the dashboard. Click "New Key", enter a name and choose an expiration (7 days, 30 days, 90 days, 1 year, or never).

2

Copy the Key

The full key (lc_…) is displayed once. Copy it and store it securely — it cannot be retrieved again.

3

Authenticate

Use the key via environment variable (LURUS_API_KEY), CLI login (lurus login --api-key) or the X-API-Key header.

Usage

Environment Variable (CI/CD)

export LURUS_API_KEY=lc_your_key_here
lurus code "implement feature X"

CLI Login

lurus login --api-key
# Paste your key when prompted

HTTP Header

curl -H "X-API-Key: lc_your_key_here" \

Security

  • Keys are stored as SHA-256 hashes — the plaintext key is never persisted
  • File permissions on auth storage set to 0600 (owner-only)
  • API key requests bypass CSRF checks (designed for non-browser clients)
  • Revoked and expired keys are automatically purged after 90 days
  • Plan-based limits: up to 5 keys on Pro, up to 10 on Pro+ and Ultra
  • Audit logs are retained for 1 year

Frequently Asked Questions

Ready to Automate?

Create your first API key and integrate Lurus Code into your CI/CD pipeline.

Get Started