Company logoTrust Center Documentation
API v1 ReferenceDocumentsIdAssetsFileid

Download a document asset

Stream a file attached to a document. The file must belong to the document either as its current file, as one of its translations, or through a stored…

GET
/api/v1/documents/{id}/assets/{fileId}

Stream a file attached to a document. The file must belong to the document either as its current file, as one of its translations, or through a stored version, and to the same tenant; anything else is a 404 rather than a 403, so a caller cannot probe for files it may not read.

PDFs and images are served inline, everything else as an attachment. Add ?download to force an attachment either way. Range and conditional request headers are passed through to the upstream store, so the response may be a 206 or a 304.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

id*string

Document the file is attached to

Formatuuid
fileId*string

File to stream

Formatuuid

Query Parameters

download?boolean

Serve the file as an attachment even when it could render inline

Header Parameters

Range?string

Passed through to the file store for partial downloads

Response Body

application/octet-stream

curl -X GET "https://example.com/api/v1/documents/550e8400-e29b-41d4-a716-446655440000/assets/7c9e6679-7425-40de-944b-e07fc1f90ae7"
"string"

How is this guide?