https://rickymoorhouse.uk/tags/versioning/ Recent content in Versioning on Ricky Moorhouse Hugo en-gb Mon, 13 Apr 2026 00:00:00 +0000 https://rickymoorhouse.uk/blog/2026/api-versioning-is-a-contract-commitment-not-a-technical-choice/ Mon, 13 Apr 2026 00:00:00 +0000 https://rickymoorhouse.uk/blog/2026/api-versioning-is-a-contract-commitment-not-a-technical-choice/ <p>Teams spend a lot of energy arguing about whether to put the version in the URL, a header, or a query parameter. That debate usually misses the point. The real question is: what is your change management discipline, and how do you protect consumers from breaking changes?</p> <p><img src="https://rickymoorhouse.uk/blog/2026/api-versioning-is-a-contract-commitment-not-a-technical-choice/windswept.jpeg" alt="Sand in the wind, Witterings"></p> <p>Taking a step up from the versioning question - how are you managing changes to your API contract? Ideally this would be transparent to consumers unless there is something they are looking to take advantage of in the new changes. If your API is designed well it can abstract any internal requirements and technical limitations from your clients such that you can update the implementation internally and their applications will continue to operate without even needing to know about it.</p>