Declaw icon

Declaw

Run code securely in Firecracker microVM sandboxes — create sandboxes, execute commands, manage files

Actions24

File → Read Binary

AI-generated

Summary

Download a binary file (image, archive, etc.) from a Declaw sandbox by absolute path and attach it to the output item as n8n binary data.

Inputs

  • Sandbox ID (required) — ID of the sandbox to read from (e.g. sbx-a1b2c3d4).
  • File Path (required) — Absolute path of the file inside the sandbox (e.g. /home/user/output.png).
  • Binary Property — Name of the binary property that will hold the downloaded file. Defaults to "data".

Output shape

One item per input item, with json {path} (the requested file path) and a binary property (named per Binary Property) containing the file bytes.

The file name is the last segment of the path (falls back to "file"). MIME type comes from the response content-type header, defaulting to application/octet-stream. It calls GET /sandboxes/{id}/files/raw. With Continue On Fail enabled, errors return an item with json {error} instead of stopping the workflow.

Examples

Example 1: Retrieve a chart image generated by code running in a sandbox, for use in a later email or upload node.

Sandbox ID = {{$json.sandbox_id}}, File Path = /home/user/chart.png, Binary Property = data

Example 2: Download a zipped build artifact produced by a command.

Sandbox ID = sbx-a1b2c3d4, File Path = /home/user/build.zip, Binary Property = archive

Links

Discussion