Skip to main content
Once a volume is mounted, use the standard sandbox filesystem APIs against the mount path.

​
Read and Write

const sandbox = await client.sandboxes.get("sandbox-id");

await sandbox.files.writeText("/mnt/workspace/notes.txt", "persisted data");
const text = await sandbox.files.readText("/mnt/workspace/notes.txt");

console.log(text);

​
List and Inspect

const entries = await sandbox.files.list("/mnt/workspace", { depth: 1 });
const info = await sandbox.files.getInfo("/mnt/workspace/notes.txt");

console.log(entries.map((entry) => entry.path));
console.log(info.size, info.permissions);

​
Upload and Download

You can also use standard filesystem transfer operations against mounted paths. 
# Upload local file into mounted volume path
hx cp ./local.txt <sandbox-id>:/mnt/workspace/local.txt

# Download from mounted volume path
hx cp <sandbox-id>:/mnt/workspace/local.txt ./downloaded.txt

​
Access Mode

  • rw mounts allow writes.
  • ro mounts reject write operations.