Authentication

The Levrage.AI API uses Bearer token authentication. All requests (except public discovery endpoints) require an API key.

Getting Your API Key

1. Log in to the Levrage.AI Studio
2. Go to Settings → Developers → API Keys
3. Click Generate New Key
4. Copy and store your key securely — it’s only shown once

Using Your API Key

Include it in the Authorization header as a Bearer token:

$
curl -H "Authorization: Bearer lev_YOUR_API_KEY" \
>
     https://api.levrage.ai/v1/agents

Code Examples

1
import requests
2
3
API_KEY = "lev_YOUR_API_KEY"
4
BASE_URL = "https://api.levrage.ai/v1"
5
6
headers = {
7
    "Authorization": f"Bearer {API_KEY}",
8
    "Content-Type": "application/json"
9
}
10
11
response = requests.get(f"{BASE_URL}/agents", headers=headers)
12
print(response.json())

Public Endpoints

These endpoints do not require authentication:

Error Responses

1
{
2
  "detail": "Invalid or expired API key"
3
}

Rate Limits

Rate limit headers are included in every response:

X-RateLimit-Limit: 300
X-RateLimit-Remaining: 295
X-RateLimit-Reset: 1706140800

Best Practices

1. Store keys in environment variables — Never hardcode in source files
2. Use server-side only — Never call the API from browser/mobile frontend
3. Rotate keys regularly — Generate new keys and revoke old ones
4. Use one key per environment — Separate keys for dev, staging, production