Download Exact File Ref
Streams the raw bytes of the exact immutable file generation named by a complete FileRef. All query values must be URL-encoded. The server resolves the id only inside the authenticated bot scope and requires the current size, content type, filename, and checksum to match; it never returns a blob key or provider URL. Unknown or duplicate query parameters are rejected, and the complete query string is limited to 4 KiB.
Authorization
BearerAuth In: header
Query Parameters
Bot-scoped file key. Encode the complete value, including slashes, spaces, plus signs, and non-ASCII characters.
1 <= length <= 1024Exact generation size in bytes. Zero-byte files are supported.
int640 <= value <= 1073741824Exact generation MIME type. Omit only when the persisted FileRef omits it.
length <= 255Exact generation filename. Omit only when the persisted FileRef omits it.
length <= 1024Exact generation checksum from the authoritative FileRef.
1 <= length <= 128Response Body
application/octet-stream
curl -X GET "https://example.com/v1/files/download-ref?id=string&size=0&checksum=string"