API Overview

Ada’s suite of APIs opens up multiple integration paths to connect Ada with external systems, extending the capabilities of your AI agent. Whether you’re looking to manage data stored in Ada or personalize conversations, Ada’s APIs supports numerous use cases, including:

  • Syncing end user profile information in real time to enable your AI Agent to be knowledgable about your users and tailor responses.
  • Managing and uploading business knowledge and policies from any source.
  • Complying with data privacy regulations around data retention and deletion.
  • Exporting conversation data for in-depth analysis or long term storage.

Fundamentals

  • Ada’s APIs adhere to REST standards and utilize JSON formatting for data exchange.

  • Secure access is managed through Authentication using rotatable keys.

  • Versioning allows to smoothly opt-in to breaking changes.

  • Global rate limits ensure high availability, with certain API families applying thier own local limits.

  • Cursor-based pagination supports efficient handling of large data sets.

API Testing

To help you get started quickly, you can use these resources to explore the API, run tests, and integrate it into your workflows. They’re designed to reduce setup time and give you hands-on experience with real requests and responses.

Download our OpenAPI spec

You can download the OpenAPI specification below. This file provides a machine-readable definition that you can use with your own tools.

Use our API Playground

Use the API Playground directly in these docs to try out requests and see live responses. This makes it easy to validate endpoints, experiment with parameters, and understand responses before integrating them into your own systems.

1

Click ▶️ Play

Next to every API call example, you’ll see a ▶️ Play button to open the playground. For example in Knowledge Sources:

API Playground

2

Enter your API key

Click Login to enter your API key.

Your key is stored securely in your local browser session and will be cleared when the tab is closed.

3

Enter your subdomain

Double-click the endpoint URL to replace example with your Ada instance’s subdomain. You can find your subdomain in the URL of your Ada dashboard.

4

Test your API call

Send requests and review responses to validate your API calls.

API Families

Knowledge API

Use the Knowledge API to import and sync knowledge articles into Ada.

End Users API

The End Users API offers allows for real-time updates and management of user profile information, including webhook events to track changes in user profiles.

Export API

The Data Export API provides access to conversation and message records. You can use this API to export data into your own data warehouse for analysis and long-term storage.

Compliance API

The Data Compliance API allows for the deletion of personal data associated with a user’s email address from Ada’s databases.

Integrations API

The Integrations API enables developers to connect external applications to Ada, such as Knowledge integrations that help AI agents generate responses, all managed from the Ada dashboard.

Conversations API

The Conversations API allows developers to build custom channels and extend Ada into proprietary apps, third-party platforms, or internal tools with developer-focused control.

Security considerations

Security-related features are documented within individual API families. The table below summarizes where to find them.

FocusApplies toLearn more
IAM (API Keys)All API familiesAuthentication
DeletionData Compliance APIHow deletion works
Delete chatter data
Audit trailsData Export APIOverview
End Users API (Webhooks)User event webhooks
TLS/HTTPSAll API familiesSee API examples