Get short-lived view links for up to 20 of your images
The batch, view-only form of GET /v1/files/{uuid}/download-link, built for image viewers such as the MCP show_images tool. No credits are charged, no image is decoded and no bytes are returned: every entry carries presigned URLs valid for 15 minutes.
- thumbnail_url opens a small stored thumbnail inline when one exists, otherwise the same image as view_url.
- view_url opens the original inline in the browser; download_url saves it.
- Every URL is a credential for 15 minutes: anyone holding it can read the file. Do not log it or pass it on.
Only raster images (JPEG, PNG, WebP, GIF, AVIF) stored in object storage get links. Any uuid that is unknown, not yours, readable only by a container scope your token lacks, not a raster image (SVG, PDF and others never get inline links), stored only on the server disk, or not presignable right now is listed in not_found instead. One list for all of these, so it reveals nothing about files you cannot read.
Authorization per uuid is the same two-layer check as the download route: files:read at the gate, then the read scope of the file's own container.
Request
- Base URL: https://contentmaschine.ai/api
- URL: https://contentmaschine.ai/api/v1/files/view-links
- Auth: one of:
- HTTP bearer
- OAuth 2 (authorization code, authorization URL https://contentmaschine.ai/api/oauth/authorize, token URL https://contentmaschine.ai/api/oauth/token)
Query parameters
1 to 20 file uuids, comma-separated in the query string. Duplicates are ignored.
Response
View links for the images that can be shown, and the uuids that cannot.
Changes
No recorded changes to this operation across all 1 revision of this API.