Migrating from API v1 to v2

This guide covers the steps to migrate from API v1 to v2.

Key Changes

Breaking Changes

  1. Base URL - All v2 endpoints use /api/v2/ prefix
  2. Response Format - Wrapper structure has changed
  3. Pagination - Cursor-based pagination replaces offset-based
  4. Authentication - Bearer token format updated

Deprecation Timeline

  • v1 will remain supported until Q4 2025
  • New features will only be added to v2

Migration Steps

  1. Update your base URL from /api/v1/ to /api/v2/
  2. Update pagination handling for cursor-based format
  3. Adjust response parsing for new wrapper structure
  4. Test all affected endpoints