Migrating from API v1 to v2
This guide covers the steps to migrate from API v1 to v2.
Key Changes
Breaking Changes
- Base URL - All v2 endpoints use
/api/v2/prefix - Response Format - Wrapper structure has changed
- Pagination - Cursor-based pagination replaces offset-based
- Authentication - Bearer token format updated
Deprecation Timeline
- v1 will remain supported until Q4 2025
- New features will only be added to v2
Migration Steps
- Update your base URL from
/api/v1/to/api/v2/ - Update pagination handling for cursor-based format
- Adjust response parsing for new wrapper structure
- Test all affected endpoints