Skip to content

Please offer pagination for /manifests endpoint in DockerHub API #795

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
lboix opened this issue Mar 11, 2025 · 2 comments
Open

Please offer pagination for /manifests endpoint in DockerHub API #795

lboix opened this issue Mar 11, 2025 · 2 comments
Labels
community_new New idea raised by a community contributor

Comments

@lboix
Copy link

lboix commented Mar 11, 2025

Tell us about your request
Hello DockerHub team,

would it possible to offer pagination in the /manifests endpoint you are exposing (example: https://hub.docker.com/v2/namespaces/NAMESPACE/repositories/REPOSITORY/manifests) ?

It's already in place for /repositories and /tags for example (like https://hub.docker.com/v2/namespaces/NAMESPACE/repositories and https://hub.docker.com/v2/namespaces/NAMESPACE/repositories/REPOSITORY/tags) through the "next" URL returned in the response, which is perfect.

Best regards

Which service(s) is this request for?
DockerHub API

Tell us about the problem you're trying to solve. What are you trying to do, and why is it hard?
It will people to reclaim storage space on heavy repositories that do exist for years.

Are you currently working around the issue?
We made our cleaning script run almost continuously as it can not treat more than 100 manifests by repo (no pagination).

Additional context
Pagination offered for /tags endpoint VS no pagination offered for /manifests endpoint :

Image
Image

@lboix lboix added the community_new New idea raised by a community contributor label Mar 11, 2025
@jcarter3
Copy link

You cannot "page" in the same way, but if you pass the last_evaluated_key field in as a query param (it's returned in the response) you can get a similar effect. The full API is not documented though as it is not finalized and can still change as we make tweaks.

@lboix
Copy link
Author

lboix commented Mar 12, 2025

Thanks @jcarter3 for the tip : I confirm that it's working perfectly

lboix added a commit to lboix/clean-dockerhub that referenced this issue Mar 12, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
community_new New idea raised by a community contributor
Projects
None yet
Development

No branches or pull requests

2 participants