Change Updates

Do not miss any Docker Hub changes, ever again

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

RSS

Changelog

Last update:
Supported registry API for Docker Hub
DVP Data API

OpenAPI document has been modified on GitHub cf PR 22935, it was not a structural change in the DVD Data API.

Docker Hub API

OpenAPI document has been modified on GitHub cf PR 22935, with one structural change: new endpoint GET /v2/namespaces/{namespace}/repositories

1 structure change including:
1 Addition
Added 1
GET /v2/namespaces/{namespace}/repositories
Docker Engine API
Docker Hub API
2-beta
49 structure changes including:
2 Breaking changes
26 Additions
21 Modifications
2 Removals
Modified 21 Breaking
GET /v2/access-tokens/{uuid}
  • Authentication
  • Bearer auth authentication method Added
GET /v2/namespaces/{namespace}/repositories/{repository}/tags
  • Authentication
  • Bearer auth authentication method Added
GET /v2/namespaces/{namespace}/repositories/{repository}/tags/{tag}
  • Authentication
  • Bearer auth authentication method Added
GET /v2/orgs/{name}/settings
  • Authentication
  • Bearer auth authentication method Added
GET /v2/scim/2.0/ResourceTypes
  • Authentication
  • Bearer scim auth authentication method Added
GET /v2/scim/2.0/ResourceTypes/{name}
  • Path
  • name path parameter Modified
    • Path parameter is now required
      Breaking
  • Authentication
  • Bearer scim auth authentication method Added
GET /v2/scim/2.0/Schemas
  • Authentication
  • Bearer scim auth authentication method Added
GET /v2/scim/2.0/Schemas/{id}
  • Path
  • id path parameter Modified
    • Path parameter is now required
      Breaking
  • Authentication
  • Bearer scim auth authentication method Added
GET /v2/scim/2.0/ServiceProviderConfig
  • Authentication
  • Bearer scim auth authentication method Added
GET /v2/scim/2.0/Users
  • Authentication
  • Bearer scim auth authentication method Added
GET /v2/scim/2.0/Users/{id}
  • Path
  • id path parameter Modified
    • Path parameter is now required
      Breaking
  • Authentication
  • Bearer scim auth authentication method Added
HEAD /v2/namespaces/{namespace}/repositories/{repository}/tags
  • Authentication
  • Bearer auth authentication method Added
HEAD /v2/namespaces/{namespace}/repositories/{repository}/tags/{tag}
  • Authentication
  • Bearer auth authentication method Added
PATCH /v2/access-tokens/{uuid}
  • Authentication
  • Bearer auth authentication method Added
POST /v2/access-tokens
  • Body
  • application/json content type Modified
    • expires_at property Added
  • Authentication
  • Bearer auth authentication method Added
POST /v2/scim/2.0/Users
  • Authentication
  • Bearer scim auth authentication method Added
POST /v2/users/login
  • Operation is now deprecated
PUT /v2/orgs/{name}/settings
  • Authentication
  • Bearer auth authentication method Added
PUT /v2/scim/2.0/Users/{id}
  • Path
  • id path parameter Modified
    • Path parameter is now required
      Breaking
  • Authentication
  • Bearer scim auth authentication method Added
GET /v2/access-tokens
  • Authentication
  • Bearer auth authentication method Added
DELETE /v2/access-tokens/{uuid}
  • Authentication
  • Bearer auth authentication method Added
Removed 2 Breaking
GET /v2/auditlogs/{account}
  • Removing a resource is always breaking unless it was deprecated before
    Breaking
GET /v2/auditlogs/{account}/actions
  • Removing a resource is always breaking unless it was deprecated before
    Breaking
Added 26
PUT /v2/orgs/{org_name}/members/{username}
DELETE /v2/invites/{id}
DELETE /v2/orgs/{org_name}/access-tokens/{access_token_id}
DELETE /v2/orgs/{org_name}/groups/{group_name}
DELETE /v2/orgs/{org_name}/groups/{group_name}/members/{username}
DELETE /v2/orgs/{org_name}/members/{username}
GET /v2/auditlogs/{account}
GET /v2/auditlogs/{account}/actions
GET /v2/orgs/{name}/access-tokens
GET /v2/orgs/{org_name}/access-tokens/{access_token_id}
GET /v2/orgs/{org_name}/groups
GET /v2/orgs/{org_name}/groups/{group_name}
GET /v2/orgs/{org_name}/groups/{group_name}/members
GET /v2/orgs/{org_name}/invites
GET /v2/orgs/{org_name}/members
GET /v2/orgs/{org_name}/members/export
PATCH /v2/invites/{id}/resend
PATCH /v2/orgs/{org_name}/access-tokens/{access_token_id}
PATCH /v2/orgs/{org_name}/groups/{group_name}
POST /v2/auth/token
POST /v2/invites/bulk
POST /v2/orgs/{name}/access-tokens
POST /v2/orgs/{org_name}/groups
POST /v2/orgs/{org_name}/groups/{group_name}/members
POST /v2/repositories/{namespace}/{repository}/groups
PUT /v2/orgs/{org_name}/groups/{group_name}
Docker Engine API
1.49
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
Docker Engine API
1.45
8 structure changes including:
8 Modifications
Modified 8
GET /containers/{id}/json
  • Response
  • 200 response Modified
    • content type Modified
      • HostConfig property Modified
GET /services
  • Response
  • 200 response Modified
    • content type Modified
GET /services/{id}
  • Response
  • 200 response Modified
    • content type Modified
      • Spec property Modified
GET /tasks
  • Response
  • 200 response Modified
    • content type Modified
GET /tasks/{id}
  • Response
  • 200 response Modified
    • content type Modified
      • Spec property Modified
POST /containers/create
  • Body
  • content type Modified
    • HostConfig property Modified
      • Mounts property Modified
POST /services/create
  • Body
  • content type Modified
    • TaskTemplate property Modified
      • ContainerSpec property Modified
POST /services/{id}/update
  • Body
  • content type Modified
    • TaskTemplate property Modified
      • ContainerSpec property Modified
Docker Engine API
Docker Hub API
DVP Data API