NHnhost
files

Check file information

Changed on

Retrieve file metadata headers without downloading the file content. Supports conditional requests and provides caching information.

head/files/{id}

Request

  • Base URL
    https://{subdomain}.storage.{region}.nhost.run/v1
  • URL
    https://{subdomain}.storage.{region}.nhost.run/v1/files/{id}
  • Auth
    HTTP bearer

Path parameters

idstring required

Unique identifier of the file to check

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

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

Response

File information headers retrieved successfully

Changes