# Appendix K: API Versioning & Deprecation Policy

# API Versioning

## Current Version: 2.0
- **Status**: Stable and supported
- **Release**: January 2024
- **Endpoints**: 102 paths, 194 operations

## Versioning Strategy
- Semantic versioning (MAJOR.MINOR)
- v1 deprecated, support ends Dec 2024
- v3 planned for 2025-2026

## Deprecation Policy
- 3 month announcement phase
- 6 month transition phase
- Removal after 12 months

## Migration Path
- Monitor Deprecation headers
- Plan upgrades early
- Use provided migration guides
- Contact support for assistance

## Version Compatibility
- Always specify version explicitly
- Don't rely on "latest"
- Subscribe to announcements