v14

latestOpenAPI 3.0.0raw.githubusercontent.com2026-05-279719892.3 MB
Files

Get signed URL to access private file

Generates signed URL that allows temporary access to a private file.

get/files/2026-03/files/{fileId}/signed-url

Path parameters

fileIdstring required

Query parameters

expirationSecondsinteger
size'icon' | 'medium' | 'preview' | 'thumb'
upscaleboolean

Response

successful operation

expiresAtstring date-time required

Timestamp of when the URL will no longer grant access to the file.

extensionstring

Extension of the requested file.

heightinteger

For image and video files. The height of the file.

namestring

Name of the requested file.

sizeinteger

Size in bytes of the requested file.

typestring

Type of the file. Can be IMG, DOCUMENT, AUDIO, MOVIE, or OTHER.

urlstring required

Signed URL with access to the specified file. Anyone with this URL will be able to access the file until it expires.

widthinteger

For image and video files. The width of the file.