v1

latestOpenAPI 3.0.0Apache License 2.02026-07-17141040.5 KB
files

Download file

Retrieve and download the complete file content. Supports conditional requests, image transformations, and range requests for partial downloads.

get/files/{id}

Path parameters

idstring required

Unique identifier of the file to download

Query parameters

qinteger

Image quality (1-100). Only applies to JPEG, WebP, AVIF and HEIC files

hinteger

Maximum height, in pixels, to resize image to while maintaining aspect ratio. Only applies to image files. Values above the server-configured maximum (default 8000) are rejected with a 400 error.

winteger

Maximum width, in pixels, to resize image to while maintaining aspect ratio. Only applies to image files. Values above the server-configured maximum (default 8000) are rejected with a 400 error.

bnumber

Blur the image using this sigma value. Only applies to image files. Values above the server-configured maximum (default 250) are rejected with a 400 error.

f'auto' | 'same' | 'jpeg' | 'webp' | 'png' | 'avif' | 'heic'

Output format for image files. Use 'auto' for content negotiation based on Accept header

Example:same

Output format for image files. Use 'auto' for content negotiation based on Accept header

Headers

if-matchstring

Only return the file if the current ETag matches one of the values provided

if-none-matchstring

Only return the file if the current ETag does not match any of the values provided

if-modified-sincestring

Date in RFC 2822 format

Example:Tue, 12 Aug 2025 12:03:50 GMT

Only return the file if it has been modified after the given date

if-unmodified-sincestring

Date in RFC 2822 format

Example:Tue, 12 Aug 2025 12:03:50 GMT

Only return the file if it has not been modified after the given date

Rangestring

Range of bytes to retrieve from the file. Format: bytes=start-end

Response

File content retrieved successfully