# Docker Engine api/v1.56.0

- Product: Docker Engine (https://whatsnew.fyi/product/docker)
- Vendor: Docker
- Date: 2026-09-03
- Version: api/v1.56.0
- Original notes: https://github.com/moby/moby/releases/tag/api/v1.56.0
- Permalink: https://whatsnew.fyi/product/docker/releases/api-v1.56.0

What's New is an index, not a publisher: every entry below links to the vendor's own release notes, which are the authoritative source. Entries are labelled where they are hand-curated sample data, pre-releases, or drawn from a secondary source such as a developer blog.

Reuse: the summaries, labels and curation here are © What's New. Quote freely with attribution and a link back; wholesale republication of the corpus is not permitted — terms: https://whatsnew.fyi/terms. The vendors' own release notes remain their publishers'.

---

- **added** — GET /containers/json now supports an annotation filter to filter containers by annotation, either by key or by key and value, similar to the existing label filter
- **added** — POST /containers/create now supports HostConfig.Umask to set the initial umask for a Unix container
- **deprecated** — Deprecated plugin.Privileges sorting methods in favor of slices.SortFunc
- **fixed** — Fix Privileges Swap implementation in api/types/plugin
- **fixed** — Fix API reference documenting an unsupported names filter for GET /configs
- **changed** — Align Healthcheck name with Go struct in api/swagger
- **changed** — Document Task.NetworksAttachments in the swagger definition

##### 1.56.0

###### Changelog

-  `GET /containers/json` now supports an `annotation` filter to filter containers by annotation, either by key (`annotation=key`) or by key and value (`annotation="key=value"`), similar to the existing `label` filter. [moby/moby#53538](https://github.com/moby/moby/pull/53538)
- `POST /containers/create` now supports `HostConfig.Umask` to set the initial umask for a Unix container. When set, the daemon includes the value in the OCI process configuration for the container's entrypoint, exec processes, and healthchecks. When omitted, the runtime's default behavior applies.[moby/moby#53463](https://github.com/moby/moby/pull/53463)
- api/docs: sync API docs v1.25 - v1.55. [moby/moby#53246](https://github.com/moby/moby/pull/53246)
- api/swagger: Align Healthcheck name with Go struct. [moby/moby#53567](https://github.com/moby/moby/pull/53567)
- api/types/plugin: Deprecated `plugin.Privileges` sorting methods in favor of `slices.SortFunc`. [moby/moby#53511](https://github.com/moby/moby/pull/53511)
- api/types/plugin: fix Privileges Swap implementation. [moby/moby#53510](https://github.com/moby/moby/pull/53510)
- api: Bump to 1.56. [moby/moby#53425](https://github.com/moby/moby/pull/53425)
- api: document Task.NetworksAttachments in the swagger definition. [moby/moby#53082](https://github.com/moby/moby/pull/53082)
- api: remove gotest.tools from tests. [moby/moby#53535](https://github.com/moby/moby/pull/53535)
- api: swagger: Use int64 for build query params. [moby/moby#53520](https://github.com/moby/moby/pull/53520)
- api: use blackbox testing. [moby/moby#53525](https://github.com/moby/moby/pull/53525)
- Fix API reference documenting an unsupported `names` filter for `GET /configs`. [moby/moby#53447](https://github.com/moby/moby/pull/53447)