> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lexq.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Authentication

> Authenticate your API requests using API keys.

## API Key Authentication

LexQ uses API keys to authenticate all API requests. Include your key in the `x-api-key` header:

```bash theme={null}
curl -X POST https://api.lexq.io/api/v1/execution/groups/{groupId} \
  -H "x-api-key: lexq_us_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"facts": {"payment_amount": 100000}}'
```

## Obtaining an API Key

1. Log in to the [LexQ Console](https://console.lexq.io)
2. Navigate to **Management → API Keys**
3. Click **Create API Key**
4. Copy the key immediately — it will not be shown again

API keys follow the format `lexq_us_` followed by a Base64 string (e.g., `lexq_us_a1b2c3d4e5f6...`).

## Key Management

| Action         | Description                                             |
| -------------- | ------------------------------------------------------- |
| **Create**     | Generate a new key with an optional description         |
| **Revoke**     | Permanently disable a key (immediate effect)            |
| **Regenerate** | Revoke the old key and issue a new one in a single step |

Revoked keys cannot be reactivated. If a key is compromised, revoke it immediately and create a new one.

## Security Best Practices

* Never expose API keys in client-side code, public repositories, or browser requests
* Use environment variables or secret managers to store keys
* Rotate keys periodically
* Use separate keys for development and production environments
* Each key is scoped to a single tenant — there is no cross-tenant access

## Scope

A single API key grants access to both the **Management API** (`/api/v1/partners`) and the **Execution API** (`/api/v1/execution`) for the same tenant.

## Rate Limits

API requests are throttled based on your plan's TPS (transactions per second) limit:

| Plan   | Max TPS |
| ------ | ------- |
| Free   | 5       |
| Growth | 50      |
| Pro    | 200     |

Exceeding the limit returns HTTP `429 Too Many Requests`.