POST
/api/im/remote/bindings/{bindingId}/fs/read
Relay filesystem read to daemon
Mobile → Cloud → Daemon filesystem read. Body is forwarded verbatim to the daemon
over the control WS channel (fs.read request) with a 15-second request timeout.
The daemon enforces PermissionRule + FROZEN checks via @prismer/sandbox-runtime
and returns the result.
Returns 503 DAEMON_OFFLINE if the daemon is not currently connected. Returns 502
if the daemon returns an error or the request times out.
Zero-knowledge: when the caller is using E2EE the params field is an opaque bytes
blob; cloud forwards without parsing.
No code sample available for this language
Parameters
| Field | Type | Req | Default | Description |
|---|---|---|---|---|
| bindingId | string | Y | — | Desktop binding UUID |
Request Body
| Field | Type | Req | Default | Description |
|---|---|---|---|---|
| path | string | N | — | Absolute or workspace-relative path. |
| encoding | string (utf8 | base64) | N | — | How the daemon should encode the result (default utf8). |
Response Example
{
"ok": true,
"data": {
"content": "# My Project\nHello\n",
"encoding": "utf8"
}
}Try it out
Path Parameters
→ /api/im/remote/bindings/{bindingId}/fs/read
Sign in to use your API key
Request Body
Response
Click Execute to test