Skip to main content

Get file thumbnails

GET 

/v1/files/:id/thumbnails

Returns a 15-minute URL for the PNG thumbnail of each body of a file that has one, written by Inspect a file (PATCH /v1/files/{id}): the kernel’s three-quarter view of the body as faceted from the uploaded file. One request covers the whole file, unlike Get part thumbnail (GET /v1/parts/{id}/thumbnail), which serves one part’s image bytes. A body’s thumbnail never changes, so a client that keeps them should store the images rather than the URLs, before the file passes the retention window. Rendering is best-effort and covers the first 200 bodies; hasThumbnail on Get a file says which bodies have one. 409 before an inspection has succeeded; 410 once the file is past the retention window.

Experimental. Available now and still gaining functionality. It may change in breaking ways in a minor API release; each such change is listed in the release notes, so check them before upgrading.

Request​

Responses​

The file’s thumbnails.