I appreciate your insights! Your approach of using OpenAPI specs to generate client libraries and marking endpoints as deprecated is a disciplined way to manage API evolution. If older versions are truly removed quickly, then URL versioning can work without much baggage.

That being said, if versioning via URLs ensures clean separation and faster deprecation in your setup, I totally see the merit in that!

Its all about clients -> how long do you typically keep deprecated versions running before removal?