hectoday
DocsCoursesChangelog GitHub
DocsCoursesChangelog GitHub

Access Required

Enter your access code to view courses.

Invalid code

← All courses

API versioning and evolution with @hectoday/http

Your API has clients, and they break when you change things. This course teaches you how to evolve your API without leaving anyone behind. You'll learn URL versioning, header versioning, side-by-side versions, deprecation headers, sunset policies, and migration strategies, all built on Hectoday HTTP.

Intermediate ~4 hours

Why versioning

  1. Breaking changes
  2. The versioning contract
  3. Project setup

Versioning strategies

  1. URL path versioning
  2. Header versioning
  3. Query parameter versioning
  4. Choosing a strategy

Building versioned APIs

  1. Side-by-side versions
  2. Version routers
  3. Validation per version

Evolving without breaking

  1. Additive changes
  2. Deprecation
  3. Field renaming and removal
  4. Changing response shapes

Lifecycle management

  1. Sunset policies
  2. Monitoring version usage
  3. Checklist

© 2026 hectoday. All rights reserved.