File Rendition

A rendition of the file. A rendition is a binary preview of the file. The format of the binary depends on the format specified in the request.

For shared files, renditions process asynchronously after upload. For private files, renditions process when the first file preview is requested, and aren’t available immediately after the file is uploaded.

Note

Resource
/connect/files/fileId/rendition
/connect/communities/communityId/files/fileId/rendition
Available since version
36.0
In versions 24.0–35.0, use /chatter/files/fileId/rendition and /connect/communities/communityId/chatter/files/fileId/rendition, which require Chatter.
HTTP methods
GET
Request parameters
Name Type Description
page Integer Specify a rendition of a specific page. The first page is 0. If you don’t specify a specific page, a rendition of the first page is returned.

For a PDF file rendition, the rendition is for the entire document. The only valid value is 0: you can’t get the rendition of a single page.

type String Specify the type of rendition to be returned. Default value is THUMB120BY90. Valid values are:
  • PDF
  • THUMB120BY90
  • THUMB240BY180
  • THUMB720BY480
Response body
Binary stream of the rendition.