> For the complete documentation index, see [llms.txt](https://docs.getlimy.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.getlimy.ai/rest-api/create-an-api-key.md).

# Create an API key

An API key authenticates your requests to the Limy REST API. You can generate, view, and revoke keys from the Limy Admin Dashboard

{% hint style="info" %}
Only account admins can generate or revoke API keys.
{% endhint %}

#### Generate a key

{% stepper %}
{% step %}
**Open the API Keys Page**

Go to **Admin Dashboard** and open the **API** entry
{% endstep %}

{% step %}
**Click Generate API key**

You'll find the button in the top-right of the page (and inside the empty state if you have no keys yet).
{% endstep %}

{% step %}
**Copy the key — it is only shown once**

After generation, Limy displays the full secret key.

Click **Copy key** to copy it to your clipboard, then store it somewhere safe&#x20;
{% endstep %}
{% endstepper %}

#### Limits

Every API key is bound to a **usage plan** that controls how often you can call the Limy API. The plan is assigned by Limy when the key is created and enforces two limits:

| Limit     | What it caps                                             | Behavior when exceeded  |
| --------- | -------------------------------------------------------- | ----------------------- |
| **Rate**  | Sustained requests per second + a short burst above that | `429 Too Many Requests` |
| **Quota** | Total requests per day, week, or month                   | `429 Too Many Requests` |

#### Revoke a key

If a key is compromised or no longer needed, open **Account settings → API**, find the key in the list, and click the trash icon. Revocation is immediate — any request using a revoked key will be rejected.

{% hint style="warning" %}
Revoked keys cannot be restored. Issue a new key if access is still needed.
{% endhint %}

#### Need help?

Reach out at `answers@limy.ai`.
