Docker Hub v1 API Deprecation

Jun 22 2022

Docker has planned to deprecate the Docker Hub v1 API endpoints that access information related to Docker Hub repositories on September 5th, 2022.

Context

At this time, we have found that the number of v1 API consumers on Docker Hub has fallen below a reasonable threshold to maintain this version of the Hub API. Additionally, approximately 95% of Hub API requests target the newer v2 API. This decision has been made to ensure the stability and enhanced performance of our services so that we can continue to provide you with the best developer experience.

How does this impact you?

After the 5th of September, the following API routes within the v1 path will no longer work and will return a 404 status code:

  • /v1/repositories/<name>/images
  • /v1/repositories/<name>/tags
  • /v1/repositories/<name>/tags/<tag_name>
  • /v1/repositories/<namespace>/<name>/images
  • /v1/repositories/<namespace>/<name>/tags
  • /v1/repositories/<namespace>/<name>/tags/<tag_name>

If you want to continue using the Docker Hub API in your current applications, you must update your clients to use the v2 endpoints. Additional documentation and technical details about how to use the v2 API are available at the following URL: https://docs.docker.com/docker-hub/api/latest/

How do you get additional help?

If you have additional questions or concerns about the Hub v1 API deprecation process, you can contact us at [email protected].

Feedback

0 thoughts on "Docker Hub v1 API Deprecation"

DockerCon 2022

With over 50 sessions for developers by developers, watch the latest developer news, trends, and announcements from DockerCon 2022. From the keynote to product demos to technical breakout sessions, hacks, and tips & tricks, there’s something for everyone.

Watch Now