File Previews

A file preview is an image thumbnail for a file.

Get a Preview of a specific File

The preview endpoint will generate a preview image on-demand for the given file. This endpoint only works with images for now. There are a bunch of image types supported to generate a preview from:

  • image/gif
  • image/jpeg
  • image/jpg
  • image/pjpeg
  • image/png
  • image/svg+xml
  • image/tiff




name type values notes
file_id integer required
platform string mac, web, windows, iphone, ipad, android optional
size string nonretina, retina optional


On Success:

200 OK

  "url": "",
  "size": "420x420",
  "expires_at": "2013-08-02T11:58:55Z",
  "type": "preview"

On Failure:

400 Bad Request

  "errors": ["bad request"]

Info: The response in a failure case can differ from the given one.

You can report issues or ask questions via our GitHub repository.