From 228441957b625a86bd32e15865ef9b8281fe052c Mon Sep 17 00:00:00 2001 From: Sebastiaan van Stijn Date: Mon, 6 Apr 2026 00:48:26 +0200 Subject: [PATCH] engine: update API-version matrix and add Minimum API version Signed-off-by: Sebastiaan van Stijn --- content/reference/api/engine/_index.md | 164 ++++++++++++------ content/reference/api/engine/version/v1.40.md | 6 + content/reference/api/engine/version/v1.41.md | 6 + content/reference/api/engine/version/v1.42.md | 6 + content/reference/api/engine/version/v1.43.md | 6 + 5 files changed, 131 insertions(+), 57 deletions(-) create mode 100644 content/reference/api/engine/version/v1.40.md create mode 100644 content/reference/api/engine/version/v1.41.md create mode 100644 content/reference/api/engine/version/v1.42.md create mode 100644 content/reference/api/engine/version/v1.43.md diff --git a/content/reference/api/engine/_index.md b/content/reference/api/engine/_index.md index 221d9b7d1d9b..99c99df14bd0 100644 --- a/content/reference/api/engine/_index.md +++ b/content/reference/api/engine/_index.md @@ -67,27 +67,27 @@ A new version of the API is released when new features are added. The Docker API is backward-compatible, so you don't need to update code that uses the API unless you need to take advantage of new features. -To see the highest version of the API your Docker daemon and client support, use -`docker version`: +To see the highest and lowest version of the API your Docker daemon and client +support, use `docker version`: ```console $ docker version Client: Docker Engine - Community - Version: 29.2.1 - API version: 1.53 - Go version: go1.25.6 - Git commit: a5c7197 - Built: Mon Feb 2 17:16:37 2026 + Version: 29.3.1 + API version: 1.54 + Go version: go1.25.8 + Git commit: c2be9cc + Built: Wed Mar 25 16:12:49 2026 OS/Arch: darwin/arm64 Context: desktop-linux Server: Docker Engine - Community Engine: - Version: 29.2.1 - API version: 1.53 (minimum version 1.44) - Go version: go1.25.6 - Git commit: 6bc6209 - Built: Mon Feb 2 17:16:47 2026 + Version: 29.3.1 + API version: 1.54 (minimum version 1.40) + Go version: go1.25.8 + Git commit: f78c987 + Built: Wed Mar 25 16:14:30 2026 OS/Arch: linux/arm64 ... ``` @@ -102,7 +102,7 @@ You can specify the API version to use in any of the following ways: - To force the Docker CLI or the Docker Engine SDKs to use an older version of the API than the version reported by `docker version`, set the environment variable `DOCKER_API_VERSION` to the correct version. This works - on Linux, Windows, or macOS clients. + on Linux, Windows, and macOS clients. {{% apiVersionPrevious.inline %}} {{- $version := site.Params.latest_engine_api_version }} @@ -128,57 +128,107 @@ You can specify the API version to use in any of the following ways: or the [Python SDK documentation for `client`](https://docker-py.readthedocs.io/en/stable/client.html). +### Minimum API version + +The Docker Engine API server and client support API-version negotiation. If +a client connects with an older version of the Docker Engine, it negotiates +the highest version of the API supported by both the client and daemon, +downgrading to an older version of the API if necessary. + +When downgrading to an older API version, features introduced in later API +versions are disabled, and API requests and responses are adjusted for the +API version negotiated. + +API version negotiation allows tools that have not been upgraded yet to the +latest API version specification to communicate with newer Docker Engines +(and vice versa), but compatibility is "best effort"; while we strive to +provide full compatibility, some functionality may not be available. + ### API version matrix -| Docker version | Maximum API version | Change log | -| :------------- | :------------------------------------------- | :----------------------------------------------------------------- | -| 29.2 | [1.53](/reference/api/engine/version/v1.53/) | [changes](/reference/api/engine/version-history/#v153-api-changes) | -| 29.1 | [1.52](/reference/api/engine/version/v1.52/) | [changes](/reference/api/engine/version-history/#v152-api-changes) | -| 29.0 | [1.52](/reference/api/engine/version/v1.52/) | [changes](/reference/api/engine/version-history/#v152-api-changes) | -| 28.5 | [1.51](/reference/api/engine/version/v1.51/) | [changes](/reference/api/engine/version-history/#v151-api-changes) | -| 28.4 | [1.51](/reference/api/engine/version/v1.51/) | [changes](/reference/api/engine/version-history/#v151-api-changes) | -| 28.3 | [1.51](/reference/api/engine/version/v1.51/) | [changes](/reference/api/engine/version-history/#v151-api-changes) | -| 28.2 | [1.50](/reference/api/engine/version/v1.50/) | [changes](/reference/api/engine/version-history/#v150-api-changes) | -| 28.1 | [1.49](/reference/api/engine/version/v1.49/) | [changes](/reference/api/engine/version-history/#v149-api-changes) | -| 28.0 | [1.48](/reference/api/engine/version/v1.48/) | [changes](/reference/api/engine/version-history/#v148-api-changes) | -| 27.5 | [1.47](/reference/api/engine/version/v1.47/) | [changes](/reference/api/engine/version-history/#v147-api-changes) | -| 27.4 | [1.47](/reference/api/engine/version/v1.47/) | [changes](/reference/api/engine/version-history/#v147-api-changes) | -| 27.3 | [1.47](/reference/api/engine/version/v1.47/) | [changes](/reference/api/engine/version-history/#v147-api-changes) | -| 27.2 | [1.47](/reference/api/engine/version/v1.47/) | [changes](/reference/api/engine/version-history/#v147-api-changes) | -| 27.1 | [1.46](/reference/api/engine/version/v1.46/) | [changes](/reference/api/engine/version-history/#v146-api-changes) | -| 27.0 | [1.46](/reference/api/engine/version/v1.46/) | [changes](/reference/api/engine/version-history/#v146-api-changes) | -| 26.1 | [1.45](/reference/api/engine/version/v1.45/) | [changes](/reference/api/engine/version-history/#v145-api-changes) | -| 26.0 | [1.45](/reference/api/engine/version/v1.45/) | [changes](/reference/api/engine/version-history/#v145-api-changes) | -| 25.0 | [1.44](/reference/api/engine/version/v1.44/) | [changes](/reference/api/engine/version-history/#v144-api-changes) | -| 24.0 | 1.43 | [changes](/reference/api/engine/version-history/#v143-api-changes) | -| 23.0 | 1.42 | [changes](/reference/api/engine/version-history/#v142-api-changes) | -| 20.10 | 1.41 | [changes](/reference/api/engine/version-history/#v141-api-changes) | -| 19.03 | 1.40 | [changes](/reference/api/engine/version-history/#v140-api-changes) | -| 18.09 | 1.39 | [changes](/reference/api/engine/version-history/#v139-api-changes) | -| 18.06 | 1.38 | [changes](/reference/api/engine/version-history/#v138-api-changes) | -| 18.05 | 1.37 | [changes](/reference/api/engine/version-history/#v137-api-changes) | -| 18.04 | 1.37 | [changes](/reference/api/engine/version-history/#v137-api-changes) | -| 18.03 | 1.37 | [changes](/reference/api/engine/version-history/#v137-api-changes) | -| 18.02 | 1.36 | [changes](/reference/api/engine/version-history/#v136-api-changes) | -| 17.12 | 1.35 | [changes](/reference/api/engine/version-history/#v135-api-changes) | -| 17.11 | 1.34 | [changes](/reference/api/engine/version-history/#v134-api-changes) | -| 17.10 | 1.33 | [changes](/reference/api/engine/version-history/#v133-api-changes) | -| 17.09 | 1.32 | [changes](/reference/api/engine/version-history/#v132-api-changes) | -| 17.07 | 1.31 | [changes](/reference/api/engine/version-history/#v131-api-changes) | -| 17.06 | 1.30 | [changes](/reference/api/engine/version-history/#v130-api-changes) | -| 17.05 | 1.29 | [changes](/reference/api/engine/version-history/#v129-api-changes) | -| 17.04 | 1.28 | [changes](/reference/api/engine/version-history/#v128-api-changes) | -| 17.03.1 | 1.27 | [changes](/reference/api/engine/version-history/#v127-api-changes) | -| 17.03 | 1.26 | [changes](/reference/api/engine/version-history/#v126-api-changes) | -| 1.13.1 | 1.26 | [changes](/reference/api/engine/version-history/#v126-api-changes) | -| 1.13 | 1.25 | [changes](/reference/api/engine/version-history/#v125-api-changes) | -| 1.12 | 1.24 | [changes](/reference/api/engine/version-history/#v124-api-changes) | +| Docker version | Maximum API version | Minimum API version | Change log | +|:---------------|:---------------------------------------------|:---------------------------------------------| :----------------------------------------------------------------- | +| 29.3 | [1.53](/reference/api/engine/version/v1.53/) | [1.40](/reference/api/engine/version/v1.40/) | [changes](/reference/api/engine/version-history/#v153-api-changes) | +| 29.2 | [1.53](/reference/api/engine/version/v1.53/) | [1.44](/reference/api/engine/version/v1.44/) | [changes](/reference/api/engine/version-history/#v153-api-changes) | +| 29.1 | [1.52](/reference/api/engine/version/v1.52/) | [1.44](/reference/api/engine/version/v1.44/) | [changes](/reference/api/engine/version-history/#v152-api-changes) | +| 29.0 | [1.52](/reference/api/engine/version/v1.52/) | [1.44](/reference/api/engine/version/v1.44/) | [changes](/reference/api/engine/version-history/#v152-api-changes) | +| 28.5 | [1.51](/reference/api/engine/version/v1.51/) | 1.24 | [changes](/reference/api/engine/version-history/#v151-api-changes) | +| 28.4 | [1.51](/reference/api/engine/version/v1.51/) | 1.24 | [changes](/reference/api/engine/version-history/#v151-api-changes) | +| 28.3 | [1.51](/reference/api/engine/version/v1.51/) | 1.24 | [changes](/reference/api/engine/version-history/#v151-api-changes) | +| 28.2 | [1.50](/reference/api/engine/version/v1.50/) | 1.24 | [changes](/reference/api/engine/version-history/#v150-api-changes) | +| 28.1 | [1.49](/reference/api/engine/version/v1.49/) | 1.24 | [changes](/reference/api/engine/version-history/#v149-api-changes) | +| 28.0 | [1.48](/reference/api/engine/version/v1.48/) | 1.24 | [changes](/reference/api/engine/version-history/#v148-api-changes) | +| 27.5 | [1.47](/reference/api/engine/version/v1.47/) | 1.24 | [changes](/reference/api/engine/version-history/#v147-api-changes) | +| 27.4 | [1.47](/reference/api/engine/version/v1.47/) | 1.24 | [changes](/reference/api/engine/version-history/#v147-api-changes) | +| 27.3 | [1.47](/reference/api/engine/version/v1.47/) | 1.24 | [changes](/reference/api/engine/version-history/#v147-api-changes) | +| 27.2 | [1.47](/reference/api/engine/version/v1.47/) | 1.24 | [changes](/reference/api/engine/version-history/#v147-api-changes) | +| 27.1 | [1.46](/reference/api/engine/version/v1.46/) | 1.24 | [changes](/reference/api/engine/version-history/#v146-api-changes) | +| 27.0 | [1.46](/reference/api/engine/version/v1.46/) | 1.24 | [changes](/reference/api/engine/version-history/#v146-api-changes) | +| 26.1 | [1.45](/reference/api/engine/version/v1.45/) | 1.24 | [changes](/reference/api/engine/version-history/#v145-api-changes) | +| 26.0 | [1.45](/reference/api/engine/version/v1.45/) | 1.24 | [changes](/reference/api/engine/version-history/#v145-api-changes) | +| 25.0 | [1.44](/reference/api/engine/version/v1.44/) | 1.24 | [changes](/reference/api/engine/version-history/#v144-api-changes) | +| 24.0 | [1.43](/reference/api/engine/version/v1.43/) | 1.12 | [changes](/reference/api/engine/version-history/#v143-api-changes) | +| 23.0 | [1.42](/reference/api/engine/version/v1.42/) | 1.12 | [changes](/reference/api/engine/version-history/#v142-api-changes) | +| 20.10 | [1.41](/reference/api/engine/version/v1.41/) | 1.12 | [changes](/reference/api/engine/version-history/#v141-api-changes) | +| 19.03 | [1.40](/reference/api/engine/version/v1.40/) | 1.12 | [changes](/reference/api/engine/version-history/#v140-api-changes) | ### Deprecated API versions -API versions before v1.44 are deprecated. You can find archived documentation +API versions before v1.40 are deprecated and no longer supported by current +versions of the Docker Engine and CLI. You can find archived documentation for deprecated versions of the API in the code repository on GitHub: - [Documentation for API versions 1.24–1.43](https://github.com/moby/moby/tree/28.x/docs/api). - [Documentation for API versions 1.18–1.23](https://github.com/moby/moby/tree/v25.0.0/docs/api). - [Documentation for API versions 1.17 and before](https://github.com/moby/moby/tree/v1.9.1/docs/reference/api). + +| Docker version | Maximum API version | Minimum API version | Change log | +|:---------------|:--------------------|:--------------------|:-------------------------------------------------------------------| +| 18.09 | 1.39 | 1.12 | [changes](/reference/api/engine/version-history/#v139-api-changes) | +| 18.06 | 1.38 | 1.12 | [changes](/reference/api/engine/version-history/#v138-api-changes) | +| 18.05 | 1.37 | 1.12 | [changes](/reference/api/engine/version-history/#v137-api-changes) | +| 18.04 | 1.37 | 1.12 | [changes](/reference/api/engine/version-history/#v137-api-changes) | +| 18.03 | 1.37 | 1.12 | [changes](/reference/api/engine/version-history/#v137-api-changes) | +| 18.02 | 1.36 | 1.12 | [changes](/reference/api/engine/version-history/#v136-api-changes) | +| 17.12 | 1.35 | 1.12 | [changes](/reference/api/engine/version-history/#v135-api-changes) | +| 17.11 | 1.34 | 1.12 | [changes](/reference/api/engine/version-history/#v134-api-changes) | +| 17.10 | 1.33 | 1.12 | [changes](/reference/api/engine/version-history/#v133-api-changes) | +| 17.09 | 1.32 | 1.12 | [changes](/reference/api/engine/version-history/#v132-api-changes) | +| 17.07 | 1.31 | 1.12 | [changes](/reference/api/engine/version-history/#v131-api-changes) | +| 17.06 | 1.30 | 1.12 | [changes](/reference/api/engine/version-history/#v130-api-changes) | +| 17.05 | 1.29 | 1.12 | [changes](/reference/api/engine/version-history/#v129-api-changes) | +| 17.04 | 1.28 | 1.12 | [changes](/reference/api/engine/version-history/#v128-api-changes) | +| 17.03.1 | 1.27 | 1.12 | [changes](/reference/api/engine/version-history/#v127-api-changes) | +| 17.03 | 1.26 | 1.12 | [changes](/reference/api/engine/version-history/#v126-api-changes) | +| 1.13.1 | 1.26 | 1.12 | [changes](/reference/api/engine/version-history/#v126-api-changes) | +| 1.13 | 1.25 | 1.12 | [changes](/reference/api/engine/version-history/#v125-api-changes) | +| 1.12 | 1.24 | 1.12 | [changes](/reference/api/engine/version-history/#v124-api-changes) | +| 1.11 | 1.23 | 1.12 | [changes](/reference/api/engine/version-history/#v123-api-changes) | +| 1.10 | 1.22 | 1.12 | [changes](/reference/api/engine/version-history/#v122-api-changes) | +| 1.9 | 1.21 | 1.12 | [changes](/reference/api/engine/version-history/#v121-api-changes) | +| 1.8 | 1.20 | 1.12 | [changes](/reference/api/engine/version-history/#v120-api-changes) | +| 1.7 | 1.19 | 1.0 | [changes](/reference/api/engine/version-history/#v119-api-changes) | +| 1.6 | 1.18 | 1.0 | [changes](/reference/api/engine/version-history/#v118-api-changes) | +| 1.5 | 1.17 | 1.0 | [changes](/reference/api/engine/version-history/#v117-api-changes) | +| 1.4 | 1.16 | 1.0 | [changes](/reference/api/engine/version-history/#v116-api-changes) | +| 1.3 | 1.15 | 1.0 | [changes](/reference/api/engine/version-history/#v115-api-changes) | +| 1.2 | 1.14 | 1.0 | [changes](/reference/api/engine/version-history/#v114-api-changes) | +| 1.1 | 1.13 | 1.0 | [changes](/reference/api/engine/version-history/#v113-api-changes) | +| 1.0 | 1.12 | 1.0 | [changes](/reference/api/engine/version-history/#v112-api-changes) | +| 0.12 | 1.12 | 1.0 | [changes](/reference/api/engine/version-history/#v112-api-changes) | +| 0.11 | 1.11 | 1.0 | [changes](/reference/api/engine/version-history/#v111-api-changes) | +| 0.10 | 1.10 | 1.0 | [changes](/reference/api/engine/version-history/#v110-api-changes) | +| 0.9 | 1.10 | 1.0 | [changes](/reference/api/engine/version-history/#v110-api-changes) | +| 0.8 | 1.9 | 1.0 | [changes](/reference/api/engine/version-history/#v19-api-changes) | +| 0.7.1 | 1.8 | 1.0 | [changes](/reference/api/engine/version-history/#v18-api-changes) | +| 0.7 | 1.7 | 1.0 | [changes](/reference/api/engine/version-history/#v17-api-changes) | +| 0.6.4 | 1.6 | 1.0 | [changes](/reference/api/engine/version-history/#v16-api-changes) | +| 0.6.2 | 1.5 | 1.0 | [changes](/reference/api/engine/version-history/#v15-api-changes) | +| 0.6 | 1.4 | 1.0 | [changes](/reference/api/engine/version-history/#v14-api-changes) | +| 0.5 | 1.3 | 1.0 | [changes](/reference/api/engine/version-history/#v13-api-changes) | +| 0.4.1 | 1.2 | 1.0 | [changes](/reference/api/engine/version-history/#v12-api-changes) | +| 0.3.4 | 1.1 | 1.0 | [changes](/reference/api/engine/version-history/#v11-api-changes) | +| 0.3.3 | 1.0 | 1.0 | [changes](/reference/api/engine/version-history/#v10-api-changes) | +| 0.3.2 | - | - | | +| 0.2 | - | - | | +| 0.1 | - | - | | diff --git a/content/reference/api/engine/version/v1.40.md b/content/reference/api/engine/version/v1.40.md new file mode 100644 index 000000000000..415da168a888 --- /dev/null +++ b/content/reference/api/engine/version/v1.40.md @@ -0,0 +1,6 @@ +--- +linkTitle: v1.40 +title: Docker Engine API v1.40 reference +aliases: + - /engine/api/v1.40/ +--- diff --git a/content/reference/api/engine/version/v1.41.md b/content/reference/api/engine/version/v1.41.md new file mode 100644 index 000000000000..aa7ec00904b1 --- /dev/null +++ b/content/reference/api/engine/version/v1.41.md @@ -0,0 +1,6 @@ +--- +linkTitle: v1.41 +title: Docker Engine API v1.41 reference +aliases: + - /engine/api/v1.41/ +--- diff --git a/content/reference/api/engine/version/v1.42.md b/content/reference/api/engine/version/v1.42.md new file mode 100644 index 000000000000..607f5da693ea --- /dev/null +++ b/content/reference/api/engine/version/v1.42.md @@ -0,0 +1,6 @@ +--- +linkTitle: v1.42 +title: Docker Engine API v1.42 reference +aliases: + - /engine/api/v1.42/ +--- diff --git a/content/reference/api/engine/version/v1.43.md b/content/reference/api/engine/version/v1.43.md new file mode 100644 index 000000000000..ea7aaf2cb2ae --- /dev/null +++ b/content/reference/api/engine/version/v1.43.md @@ -0,0 +1,6 @@ +--- +linkTitle: v1.43 +title: Docker Engine API v1.43 reference +aliases: + - /engine/api/v1.43/ +---