API Keys

Overview

API keys are managed via the Lev web app or the /build/api-keys REST endpoints. Keys are tied to the authenticated user's account and inherit their permissions.

• Keys are prefixed with lev_sk_ for identification
• The full key value is only shown once at creation — store it immediately
• Revoked keys take effect immediately
• Each account has a maximum number of allowed keys (visible via GET /me)

Creating Keys via the Lev Web App

The fastest way to create an API key is through the Lev settings page at app.lev.com.

To create a key:

1. Sign in to app.lev.com
2. Click your name at the bottom of the sidebar, then click Settings
3. Select the API Keys tab
4. Click the Create key button
5. Enter a descriptive label (e.g., "Production Sync" or "CI Pipeline") and click Create
6. Copy your key immediately — click the copy icon next to the key. It will only be shown once
7. Click Done

To revoke a key:

1. Go to Settings → API Keys (same navigation as above)
2. Find the key in the list and click the trash icon
3. Confirm by clicking Revoke key — access is revoked immediately

Create Key (API)

{
  "request_id": "...",
  "timestamp": "2026-03-20T15:30:45Z",
  "data": {
    "id": 42,
    "label": "CI Pipeline Key",
    "key_prefix": "lev_sk_abc1",
    "api_key": "lev_sk_abc123def456ghi789...",
    "created_at": "2026-03-20T15:30:45Z"
  }
}

List Keys (API)

{
  "request_id": "...",
  "timestamp": "2026-03-20T15:30:45Z",
  "data": [
    {
      "id": 42,
      "label": "CI Pipeline Key",
      "key_prefix": "lev_sk_abc1",
      "created_at": "2026-03-20T15:30:45Z",
      "last_used_at": "2026-03-19T12:00:00Z"
    }
  ],
  "pagination": {
    "total": 3,
    "limit": 50,
    "offset": 0,
    "has_more": false
  }
}

Revoke Key (API)

{
  "request_id": "...",
  "timestamp": "2026-03-20T15:30:45Z",
  "data": {
    "deleted": true
  }
}