Simplified file retrieval from Vercel Sandbox environments

The Vercel Sandbox SDK now includes two new methods that make file retrieval simple.

When you run code in a Vercel Sandbox, that code can generate files like a CSV report, a processed image, or a PDF invoice. These files are created inside isolated VMs, so they need to be retrieved across a network boundary. Until now, this required manual stream handling with custom piping.

Copy link to headingDownload a file

If you want to download a generated report from your sandbox to your local machine, you can use downloadFile() to seamlessly stream the contents.

1
const dstPath = await sandbox.downloadFile(
2
  { path: 'generated-file.csv', cwd: '/vercel/sandbox' },
3
  { path: 'generated-file.csv', cwd: '/tmp' }
4
);

Copy link to headingRead file contents to buffer

Both methods handle the underlying stream operations automatically. For example, if your sandbox runs a script that generates a chart as a PNG, you can pull it out with a single call to readFileToBuffer(), no manual stream wiring needed.

​const buffer = await sandbox.readFileToBuffer({ path: 'chart.png' });​

Learn more about the Sandbox SDK or explore the updated documentation.