Stream the binary content of a record's file.

Overview:

Returns the stored file's bytes with the file's own Content-Type (for an uploaded file, the MIME type it was uploaded with, followed by ; charset=utf-8, for example text/plain; charset=utf-8 or application/json; charset=utf-8). No Content-Disposition header is sent for uploaded files.

Use cases:

• File downloads
• Inline document preview
• Content extraction pipelines

Format conversion:

convertTo=application/pdf asks for a PDF rendering of documents that can be converted. Any other value, and the conversion request for a plain-text file, is ignored: the original file is returned.

Access: the caller needs access to the record (any role on its knowledge base). Without it, and for a record in the trash, the answer is 403. An unknown record, or an id that is not a record (a knowledge base id), is 404. A folder has no content: the answer is 502.

Errors that come from the connector service are relayed with its status as {"error": "<message>"} (StreamRecordErrorResponse); errors raised by the gateway itself (400, 401, scope 403, malformed body 500) use ErrorResponse.

Request: unknown query parameters are ignored.