npm install## API Migration Plan ### Phase 1: Deprecate v1 endpoints - Mark all v1 routes with sunset header - Add migration guide to docs - Notify active consumers via email - Set deprecation date: 2026-05-01 ### Phase 2: Build v2 handlers - New REST endpoints with consistent naming - Add request/response validation - Implement rate limiting per API key - Add OpenAPI spec generation ### Phase 3: Migration period - Run v1 and v2 in parallel for 30 days - Log v1 usage to identify stragglers - Send weekly migration reminders - Provide automated migration scripts ### Phase 4: Sunset v1 - Return 410 Gone on all v1 endpoints - Keep v1 docs archived but marked deprecated - Monitor for any remaining v1 traffic ### Timeline - Phase 1: Apr 7-11 - Phase 2: Apr 14-25 - Phase 3: May 1-30 - Phase 4: Jun 1 ### Risks - Third-party integrations may break if not notified - Some internal tools still hardcode v1 paths - Rate limiting may need tuning based on current usage patterns