Files
docker-docs/content/reference/api/hub/deprecated.md
Vincent DAMERY c69c0b53dd [docker-hub-api] add list namespace repositories endpoint (#22934)
<!--Delete sections as needed -->

## Description

- Add "new" list repositories in a given namespace endpoint : `GET
/v2/namespaces/{namespace}/repositories`

---
After the comments from @thaJeztah 
- Split DVP Data API and Docker Hub API for better visiblity
- Standardize sub entries in the side menu : Changelog, Deprecated and
OpenAPI
- Deprecated is now a table like in
https://docs.docker.com/engine/deprecated/

## Related issues or tickets

- https://github.com/docker/hub-feedback/issues/2357

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [x] Technical review
- [ ] Editorial review
- [ ] Product review
2025-07-15 08:46:14 -07:00

4.1 KiB

description, keywords, title, linkTitle, weight, aliases
description keywords title linkTitle weight aliases
Deprecated Docker Hub API endpoints deprecated Deprecated Docker Hub API endpoints Deprecated 3
/docker-hub/api/deprecated/

This page provides an overview of endpoints that are deprecated in Docker Hub API.

Endpoint deprecation policy

As changes are made to Docker there may be times when existing endpoints need to be removed or replaced with newer endpoints. Before an existing endpoint is removed it is labeled as "deprecated" within the documentation. After some time it may be removed.

Deprecated endpoints

The following table provides an overview of the current status of deprecated endpoints:

Deprecated: the endpoint is marked "deprecated" and should no longer be used.

The endpoint may be removed, disabled, or change behavior in a future release.

Removed: the endpoint was removed, disabled, or hidden.


Status Feature Date
Deprecated Deprecate /v2/repositories/{namespace} 2025-06-27
Create deprecation log table 2025-06-27
Removed Docker Hub API v1 deprecation 2022-08-23

Deprecate legacy ListNamespaceRepositories

Deprecate undocumented endpoint GET /v2/repositories/{namespace} replaced by List repositories.


Create deprecation log table

Reformat page


Docker Hub API v1 deprecation

Docker Hub API v1 has been deprecated. Use Docker Hub API v2 instead.

The following API routes within the v1 path will no longer work and will return a 410 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, update your clients to use v2 endpoints.

OLD NEW
/v1/repositories/{name}/tags /v2/namespaces/{namespace}/repositories/{repository}/tags
/v1/repositories/{namespace}/{name}/tags /v2/namespaces/{namespace}/repositories/{repository}/tags
/v1/repositories/{namespace}/{name}/tags /v2/namespaces/{namespace}/repositories/{repository}/tags/{tag}
/v1/repositories/{namespace}/{name}/tags/{tag_name} /v2/namespaces/{namespace}/repositories/{repository}/tags/{tag}