Skip to main content

Endpoint

GET /download-folder/{path}
Auth: Public (rate limited)

Path parameters

path
string
required
Path to the folder relative to the storage root.photos · videos/2024

Response

Returns a ZIP archive containing every file under the folder (recursively), with each entry’s path preserved relative to the folder.
HeaderValue
Content-Typeapplication/zip
Content-Dispositionattachment; filename="{folderName}.zip"
Content-LengthArchive size in bytes
Cache-Controlprivate, no-store
Status codes: 200 success · 400 missing or invalid path · 404 folder not found or empty · 500 error

Example

curl -O -J http://localhost:3000/download-folder/photos

Download Multiple Items

Bundle a mixed selection of files and folders into one ZIP.

Download Original File

Download a single file.