jargon

Backend & systems·API and interface design

you put /v2 in the path because the change you need cannot be made without breaking the callers on /v1.

API versioning

Running more than one contract at once so consumers can migrate on their own schedule. Whether it lives in the path, a header or a media type matters far less than the operational fact: you now maintain, test and monitor every live version. Versions are cheap to create and extremely expensive to retire.

Commonly confused with