---
answer: direct
beat: backend-engineering
source: 1 article · updated: November 15, 2026
---

Should API versioning reside in the URI path or in HTTP request headers?

URI path versioning (/v1/payments) is the industry standard for public APIs due to simplicity, transparent browser cacheability, and clear developer ergonomics. Header-based versioning (Accept: application/vnd.company.v1+json) conforms strictly to REST semantics but complicates debugging and proxy caching.

Answered in

Modern REST API Design: Noun-Based Resources, Idempotency Keys, Cursor Pagination, and Security Hardening

An architectural guide to designing production REST APIs: idempotent mutations, cursor pagination, status code precision, and zero-trust security.

Crashtech Editorial November 15, 2026 Backend Engineering

Read the full analysis

Other questions this article answers

More backend engineering questions

Every answer on Crashtech is written by the editor of the article it comes from — never auto-summarised. Browse all answers or the Backend Engineering beat.