docs: document paginated upload files endpoint and legacy behavior

[dosubot]

Update documentation for strapi/strapi#26597

Updated the upload REST API documentation to add the new /api/upload/files/page endpoint for retrieving paginated media files. The page now includes example requests/responses and a table of supported query parameters, and notes that it follows Strapi’s standard pagination format and respects api.rest.defaultLimit/api.rest.maxLimit. The existing /api/upload/files endpoint is clarified as a legacy flat-array endpoint without pagination, with a caution to use the paginated endpoint for large media libraries.

Generated by Dosu

[strapi-cla]

Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.
_{You have signed the CLA already but the status is still pending? Let us recheck it.}

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
documentation	Ready	Preview, Comment	Jun 11, 2026 8:49am