Skip to main content

Endpoint

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

Path parameters

path
string
required
Path to the file relative to the storage root, including the file extension.photo.jpg · videos/clip.mp4 · assets/logo.png

Response

Returns the raw binary content of the original file with Content-Disposition: attachment — browsers will prompt a download rather than displaying inline.
HeaderValue
Content-TypeDetected from file extension
Content-Dispositionattachment; filename="{filename}"
Content-LengthFile size in bytes
Cache-Controlprivate, no-store
Status codes: 200 success · 400 invalid path · 404 not found · 500 error

Example

curl -O -J http://localhost:3000/download/photos/portrait.jpg
GET /download/photos/portrait.jpg HTTP/1.1
Host: localhost:3000

Transform Media

Serve transformed versions instead of the original.

Upload Files

Upload new files.