---
url: /docs/resources/references/adr/2020-12-02-removing-api-version.md
---

# API version removal

::: info
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](https://github.com/shopware/shopware/blob/trunk/adr/2020-12-02-removing-api-version.md)
:::

## Context

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.

## Decision

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`).

## Consequences

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