API Keys

Overview

API keys are managed via the Lev web app or the /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 based on its API tier

Tier ceilings

The current count and ceiling for your account are returned under platform.api_keys in the scoped GET /me response — { current_count, max_allowed }. A POST /api-keys request that would exceed the ceiling returns 422 validation_error.

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.

Create a key

1. Sign in to Lev

   Sign in at app.lev.com.

   You're in your Lev workspace.
2. Open Settings

   Click your name at the bottom of the sidebar, then click Settings.

   The Settings page is open.
3. Go to the API Keys tab

   Select the API Keys tab.

   You see the list of existing keys for your account.
4. Create a new key

   Click the Create key button.

   A dialog asks you to label the new key.
5. Label and create

   Enter a descriptive label (for example, "Production Sync" or "CI Pipeline") and click Create.

   The new key is generated and shown exactly once.
6. Copy the key immediately

   Click the copy icon next to the key. Store it somewhere secure, then click Done.

   Your key is stored safely — you won't see it again.

Revoke a key

1. Open API Keys settings

   Go to Settings → API Keys.

   You see all active keys for your account.
2. Trash the key

   Find the key in the list and click the trash icon.

   A confirmation dialog opens.
3. Confirm revocation

   Click Revoke key. Revocation is instant.

   The key is revoked and any subsequent request using it returns 401 Unauthorized.

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
  }
}