API Versioning

Evolve your API without breaking existing clients.

When to Use This Skill

• Public APIs with external consumers
• Mobile apps (can't force updates)
• Breaking changes to existing endpoints
• Long-term API maintenance

Versioning Strategies

1. URL Path Versioning (Recommended)

GET /api/v1/users
GET /api/v2/users