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.

To use an API key, simply include it as a Bearer token in the Authorization header of your requests. See Authenticate your requests for detailed instructions.

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.

     

   • If you’re using a scripted bot, go to Settings > Integrations > APIs.

     

   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.

   

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

   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.

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

1
curl --location '{BOT_URL}/api/knowledge/v1/articles' \
2
--header 'Authorization: Bearer {YOUR_API_TOKEN}'

Example responses

1
// If the request is not authenticated
2
status: 401
3
{
4
	"message": "Unauthorized"
5
}
6
7
// If the request is authenticated
8
status: 200
9
{
10
	"data": []
11
}