Change Updates

Do not miss any Docker Engine API changes, ever again

Subscribe to the Docker Engine API changelog to be up to date on recent changes.

RSS

May 2, 2025

main
1.49
Compare
1.49

API structure has changed

Next change
27 structure changes including:
27 Modifications
Modified 27 Breaking
GET /containers/json
  • Response
  • 200 response Modified
    • application/json content type Modified
      • HostConfig property Modified
        • Annotations property Added
      • NetworkSettings property Modified
        • Networks property Modified
      • ImageManifestDescriptor property Added
GET /containers/{id}/json
  • Response
  • 200 response Modified
    • application/json content type Modified
      • HostConfig property Modified
        • Mounts property Modified
      • NetworkSettings property Modified
        • Networks property Modified
      • ImageManifestDescriptor property Added
GET /containers/{id}/stats
  • Response
  • 200 response Modified
    • application/json content type Modified
      • name, id, read, preread, pids_stats, blkio_stats, num_procs, storage_stats, cpu_stats, precpu_stats, memory_stats, networks properties Added
GET /distribution/{name}/json
  • Response
  • 200 response Modified
    • application/json content type Modified
      • Descriptor property Modified
        • urls, annotations, data, platform, artifactType properties Added
GET /images/get
  • Query
  • platform query parameter Added
GET /images/json
  • Response
  • 200 response Modified
    • application/json content type Modified
      • Manifests, Descriptor properties Added
  • Query
  • manifests query parameter Added
GET /images/{name}/get
  • Query
  • platform query parameter Added
GET /images/{name}/history
  • Query
  • platform query parameter Added
GET /images/{name}/json
  • Response
  • 200 response Modified
    • application/json content type Modified
      • Container, ContainerConfig properties Removed
        • Removing a resource is always breaking unless it was deprecated before
          Breaking
      • Descriptor, Manifests properties Added
  • Query
  • manifests query parameter Added
GET /info
  • Response
  • 200 response Modified
    • application/json content type Modified
      • RegistryConfig property Modified
        • AllowNondistributableArtifactsCIDRs, AllowNondistributableArtifactsHostnames properties Removed
          • Removing a resource is always breaking unless it was deprecated before
            Breaking
      • ContainerdCommit property Modified
        • Expected property Removed
          • Removing a resource is always breaking unless it was deprecated before
            Breaking
      • RuncCommit property Modified
        • Expected property Removed
          • Removing a resource is always breaking unless it was deprecated before
            Breaking
      • InitCommit property Modified
        • Expected property Removed
          • Removing a resource is always breaking unless it was deprecated before
            Breaking
      • FirewallBackend, Containerd properties Added
GET /networks
  • Response
  • 200 response Modified
    • application/json content type Modified
      • EnableIPv4, ConfigFrom, ConfigOnly, Peers properties Added
GET /networks/{id}
  • Response
  • 200 response Modified
    • application/json content type Modified
      • EnableIPv4, ConfigFrom, ConfigOnly, Peers properties Added
GET /services
  • Response
  • 200 response Modified
    • application/json content type Modified
      • Spec property Modified
        • TaskTemplate property Modified
GET /services/{id}
  • Response
  • 200 response Modified
    • application/json content type Modified
      • Spec property Modified
        • TaskTemplate property Modified
GET /system/df
  • Response
  • 200 response Modified
    • application/json content type Modified
      • Images property Modified
        • Manifests, Descriptor properties Added
      • Containers property Modified
        • HostConfig, NetworkSettings properties Modified
        • ImageManifestDescriptor property Added
GET /tasks
  • Response
  • 200 response Modified
    • application/json content type Modified
      • Spec property Modified
        • ContainerSpec property Modified
GET /tasks/{id}
  • Response
  • 200 response Modified
    • application/json content type Modified
      • Spec property Modified
        • ContainerSpec property Modified
POST /build/prune
  • Query
  • reserved-space, max-used-space, min-free-space query parameters Added
POST /containers/create
  • Body
  • application/json content type Modified
    • HostConfig property Modified
      • Mounts property Modified
        • TmpfsOptions property Modified
        • ImageOptions property Added
    • NetworkingConfig property Modified
      • EndpointsConfig property Modified
        • * property Modified
  • application/octet-stream content type Modified
    • HostConfig property Modified
      • Mounts property Modified
        • TmpfsOptions property Modified
        • ImageOptions property Added
    • NetworkingConfig property Modified
      • EndpointsConfig property Modified
        • * property Modified
POST /containers/{id}/resize
  • Query
  • h, w query parameters Modified
    • Query parameters are now required
      Breaking
POST /exec/{id}/resize
  • Query
  • h, w query parameters Modified
    • Query parameters are now required
      Breaking
POST /images/load
  • Query
  • platform query parameter Added
POST /images/{name}/push
  • Query
  • platform query parameter Added
POST /networks/create
  • Body
  • application/json content type Modified
    • CheckDuplicate property Removed
      • Removing a resource is always breaking unless it was deprecated before
        Breaking
    • Scope, ConfigOnly, ConfigFrom, EnableIPv4 properties Added
  • Response
  • 201 response Modified
    • application/json content type Modified
      • Id, Warning properties Modified
        • Properties are now required
          Breaking
POST /networks/{id}/connect
  • Body
  • application/json content type Modified
    • EndpointConfig property Modified
      • GwPriority property Added
POST /services/create
  • Body
  • application/json content type Modified
    • TaskTemplate property Modified
      • ContainerSpec property Modified
        • Mounts property Modified
        • OomScoreAdj property Added
POST /services/{id}/update
  • Body
  • application/json content type Modified
    • TaskTemplate property Modified
      • ContainerSpec property Modified
        • Mounts property Modified
        • OomScoreAdj property Added