> This page is for version Generative (default).
> For other versions, use one of these documentation indexes:
> - Generative (default): https://developers.ada.cx/generative/llms.txt
> - Scripted: https://developers.ada.cx/scripted/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.ada.cx/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.ada.cx/_mcp/server.

# Authentication

Ada APIs use API keys for authentication. An API key is required to authenticate requests and enable integration with Ada’s platform.

* **Support for Multiple Keys:** Maintain multiple active API keys to enable seamless key rotation when needed.
* **Non-Expiring:** API keys remain valid until manually revoked.
* **Access:** API keys grant both read and write permissions for all APIs available to your organization.

To create a new API key, follow the steps in [Generate an Ada API key](#generate-an-ada-api-key).

To use an API key, simply include it as a `Bearer` token in the `Authorization` header of your requests. See [Authenticate your requests](#authenticate-your-requests) for detailed instructions.

> **Note**
>
> If you are already using API-specific keys, they will only work for the v1 version of the designated API. These keys are labeled with the API name followed by "(Legacy)".

## Generate an Ada API key

You can generate a new Ada API key from the Ada dashboard, which works for all APIs your organization has access to.

1. On the Ada dashboard, go to your API settings.

   * If you're using a **generative AI Agent**, go to **Platform** > **APIs**.

     ![](/_fern-files/_img/e5da73eed06c67745185561ac1e57a1283a46a52c70ceae067702d1ca9dea1d0.webp)

   * If you're using a **scripted bot**, go to **Settings** > **Integrations** > **APIs**.

     ![](/_fern-files/_img/97b4f583afa689dd7ab938b63f7fb4c00369874faac1eba08fc7345ea9cba924.webp)

   The API keys page opens.

2. Create a new API key:

   * If your AI Agent doesn't have any API keys, click **Get started**.
   * If your AI Agent has existing API keys, click **New API key**.

   The New API key window opens.

3. In the New API key window, enter a **Name** for the key, then click **Generate key**.

   You won't be able to change the key's name in the future.

   ![](/_fern-files/_img/ff6742fcbabb2e8b12b4321351062cb1146ffcb1d447ab5416b5cb3b539ce1dc.webp)

4. Click **Copy** to copy your API key, then save it in a secure place immediately.

   > **Warning**
   >
   > For security reasons, the Ada dashboard only displays your API key once. If you lose this key, you'll need to create a new one.

5. Click **Done** to close the New API Key window and protect your new API key.

## Delete an Ada API key

If you ever need to invalidate an old API key, click the **Delete** button beside it.

![](/_fern-files/_img/0a70a91c67b4b64f270c8eaeadde0185bce65d7c490400b9256eb6bff7b23483.webp)

## Authenticate your requests

To authenticate your requests, you have to send your API key in the Authorization header in all requests to the API. Without it, your requests will fail.

### Example of a request

**`JSON`**

```json JSON
curl --location '{BOT_URL}/api/knowledge/v1/articles' \
--header 'Authorization: Bearer {YOUR_API_TOKEN}'
```

### Example responses

**`JSON`**

```json JSON
// If the request is not authenticated
status: 401
{
	"message": "Unauthorized"
}

// If the request is authenticated
status: 200
{
	"data": []
}
```