Overview

• Inspect paths and metadata.
• Read and write text or bytes.
• Move, copy, and remove files.
• Watch for file system changes.
• Upload, download, and generate presigned transfer URLs.

​

Quick Start

await sandbox.files.writeText("/tmp/hello.txt", "hello from sandbox");

const text = await sandbox.files.readText("/tmp/hello.txt");
console.log(text);

​

Available Capabilities

• Path existence, stat, and directory listing.
• Partial reads with offset and length.
• Text writes, byte writes, and batch writes.
• Directory creation plus move, copy, chmod, chown, and remove.
• File watches for change streams.
• Raw upload and download.
• Presigned upload and download URLs, including one-time URLs.

​

In This Section

• Read And Write Operations
• Watch
• Upload, Download, And Presigned URLs

​

Related Docs

• Start with Creating Sandboxes.
• Use Base Images to choose a built-in runtime.
• Use Build And Upload A Custom Image when you need a custom runtime image.