Skip to main content

A file resource.

​
id
string<uuid>
​
name
string

File name.

​
createdAt
string<date-time>

UTC timestamp of the moment this file was uploaded.

​
deletedAt
string | null

UTC timestamp of the moment this file was deleted. When null, file is not deleted.

​
contentLength
integer

File size in bytes.

Required range: x >= 1
​
contentType
enum<string>
Available options:
eml message/rfc822,
image/heic,
image/heif,
image/jpe,
image/jpg,
image/pjpeg,
image/gif,
image/bmp,
image/tif,
image/tiff,
image/x-dcraw,
image/x-jb2,
image/x-jbig2,
image/x-jpf,
image/x-ms-bmp,
image/x-panasonic-raw,
image/x-pcx,
image/x-icon,
image/x-png,
image/vnd.microsoft.icon,
image/webp,
image/x-portable-anymap,
text/plain,
text/csv,
text/rtf,
text/calendar,
text/comma-separated-values,
text/markdown,
application/pdf,
application/msword,
application/xls,
application/x-csv,
application/ms-excel,
application/vnd.ms-office,
application/vnd.ms-word,
application/vnd.ms-outlook,
application/vnd.ms-powerpoint,
application/vnd.ms-excel,
application/vnd.oasis.opendocument.text,
application/vnd.oasis.opendocument.spreadsheet,
application/vnd.oasis.opendocument.presentation,
application/vnd.oasis.opendocument.graphics,
application/vnd.openxmlformats-officedocument.wordprocessingml.document,
application/vnd.openxmlformats-officedocument.spreadsheetml.sheet,
application/vnd.openxmlformats-officedocument.presentationml.presentation,
application/vnd.openxmlformats-officedocument.presentationml.slideshow,
application/vnd.openxmlformats-officedocument.presentationml.template,
application/x-7z-compressed,
application/rar,
application/x-rar,
application/zip,
application/csv,
application/rtf,
application/text,
application/txt,
application/x-pdf
​
extension
string

Inferred from content-type (e.g.: '.pdf', '.doc', '.txt', etc...).

​
totalPages
integer

Number of pages of a document file.

Required range: x >= 0