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:
https://example.ada.support/api/end-users/v1/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/messagesBackward-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.