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
- 200
- 400
- 401
- 403
- 404
- 409
- 410
- 500
- 503
The file’s thumbnails.
The request is invalid.
The API key is missing or invalid.
The API key may not perform this operation: it has no access to this part of the API, it may only read it, or its creator has not met the organization’s two-factor requirement.
The file does not exist.
The file has not been inspected yet.
The file is older than the retention window and is no longer available.
The thumbnails could not be retrieved.
Authentication is temporarily unavailable.