> 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.

# v2 API release

Ada is releasing a new version (v2) of our platform APIs. For detailed instructions on how to migrate your integrations, please see our [Migration Guide](https://developers.ada.cx/reference/introduction/migrate-to-v-2).

In addition to an updated developer documentation site, we're adding the following capabilities to our platform in this release:

**API Endpoints Consolidation**

Several legacy endpoints have been merged and restructured by resource and action. This makes integrations simpler and reduces redundancy. For example:

* v1: `https://example.ada.support/api/end-users/v1/`
* v2: `https://example.ada.support/api/v2/end-users/`

**Streamlined API Tokens**

A single API token now works across all endpoints. Previously, separate tokens were required per API. This change simplifies token management and authentication.

**Uniform Response Structures**

Responses (including error messages) are now standardized. This reduces the complexity of handling different response formats and improves overall consistency.

**Standardized Pagination**

Pagination parameters and response metadata are now consistent, enhancing the developer experience when handling large data sets.

**Improved Rate & Data Limits**

More transparent rate and data limit policies have been introduced. This ensures better reliability, prevents unexpected throttling, and makes it easier to plan request volumes.

**Data Export API Updates**

The Data Export API endpoints have been updated to follow the new v2 naming convention:

* `/api/data_api/v1.4/conversations` → `/api/v2/export/conversations`
* `/api/data_api/v1.4/messages` → `/api/v2/export/messages`

**Backward-Incompatible Changes**

Some v1 functionality has been deprecated or altered. Review your current integrations and ensure you’re using the appropriate v2 endpoints and parameters.