API versioning

Giving an API contract a version so that incompatible changes can be released without breaking clients that use the old one.

In more detail

A version can live in the path (/v2/tasks), in a media type, or in a header; choose one clear place. Version only for breaking changes you are prepared to support and operate, not for every commit, and prefer additive changes that need no new version.

Related terms

Taught in

References