Reference

files

Downloads of files returned as a FileRef. Index · shared schemas · errors.

Procedure	Summary	REST	MCP tool	Stability
`files.get`	Download a file returned as a `FileRef`. Crash reports also need `logs:read`.	`GET`	—	stable

Download a file returned as a FileRef. Crash reports also need logs:read.


REST	`GET /v1/files/get` (input as query parameters)
RPC	`/rpc/v2/files/get`
MCP	not a tool (a binary output other than an image); hints: read-only, idempotent
Auth	`devices:read`
Tenancy	`project`
Troupe Cloud	relayed through the host agent to the device host’s runtime
Stability	stable, since 1.0

Input:

TypeScript

{ fileId: FileId }

Output: a binary body, */* (the raw response body with its Content-Type).

Errors: U, NOT_FOUND.

Named types: FileId.