Skip to content

API version removal

API version removal


This document represents an architecture decision record (ADR) and has been mirrored from the ADR section in our Shopware 6 repository. You can find the original version here


Due to the new deprecation strategy and the 6-8 months major cycle, API versioning is no longer reasonable or even possible. Deprecated fields and routes are currently tagged in a minor version and will be removed with the next major version. The API version is currently not increased in a minor version, which would not make sense, because with every second minor version deprecations would have to be removed.


By removing the API versioning within the URL we want to simplify usage and the deprecation strategy of our API. The deprecated fields and routes are shown in the OpenAPI scheme as well as the API changelog and will be removed with the next major version (6.x).


All route URLs are changed from /api/v{VERSION}/product to /api/product. Beginning with both route URLs are accessible via /api/v{VERSION}/product and /api/product before and until the release of in order to enable preparation of connections well in advance.