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"

Community All-Hands

Join us for our next Community All-Hands on September 1, 2022. This event is a unique opportunity for the Docker community and staff to come together. Don’t miss out on this special meetup with community news, company and product updates, demos, language-specific tracks, and our first-ever virtual unconference.

Register Now