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.

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.

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.