midAPI Design

How to handle API Versioning?

Updated Apr 28, 2026

Short answer

Common strategies include URI versioning (/v1/), Header versioning, or Query parameter versioning.

Deep explanation

Intermediate API design involves handling complexity and security. Common strategies include URI versioning (/v1/), Header versioning, or Query parameter versioning.

Real-world example

GitHub API using cursors for navigating large lists of commits.

Common mistakes

  • Not versioning the API from day one, leading to breaking changes.

Follow-up questions

  • Is PUT idempotent?
  • Is POST idempotent?

More API Design interview questions

View all →