API Versioning
4 min read Quiz at the end
Version from day one — URL path versioning is most common, deprecate old versions with Sunset headers.
API Versioning
# URL versioning (most common)
GET /api/v1/users
GET /api/v2/users
# Header versioning
GET /api/users
API-Version: 2
# Best practices:
# - Version from day 1 (/v1/)
# - Never break existing clients
# - Sunset header (RFC 8594)
Sunset: Sat, 31 Dec 2025 23:59:59 GMT
Deprecation: true
Link: ; rel="successor-version"
# Support 2 versions simultaneously
Topic Quiz · 1 questions
Test your understanding before moving on
1. Which versioning strategy puts the version in the URL path?
💡 URL path versioning (/api/v1/) is most visible and most commonly used in production APIs.