> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ppio.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Work with files in a sandbox

> Read, write, upload, download and watch files in the isolated sandbox filesystem, and mount an S3 bucket or read file and directory metadata with the SDK.

Each sandbox has a completely isolated filesystem. This section covers how to operate it with the SDK, from reading a single file to mounting an object storage bucket.

> [card] [Read and write files](https://docs.ppio.ai/sandbox/filesystem/read-write.md)
>
> Read a file, write one file, or write several files in one call.

> [card] [Get file and directory metadata](https://docs.ppio.ai/sandbox/filesystem/metadata.md)
>
> Retrieve the name, type, path, size, permissions and owner of a path.

> [card] [Watch a directory for changes](https://docs.ppio.ai/sandbox/filesystem/watch.md)
>
> React to create, write, remove, rename and chmod events.

> [card] [Upload files to a sandbox](https://docs.ppio.ai/sandbox/filesystem/upload.md)
>
> Send a local file or a directory, or hand the upload to a browser.

> [card] [Download files from a sandbox](https://docs.ppio.ai/sandbox/filesystem/download.md)
>
> Copy a file out of the sandbox, or issue a pre-signed download URL.

> [card] [Mount an S3 bucket in a sandbox](https://docs.ppio.ai/sandbox/filesystem/mount-s3.md)
>
> Reach objects through file paths with a FUSE mount.


## Related topics

- [How Agent Sandbox billing works](https://docs.ppio.ai/sandbox/billing.md)
- [Upload files to a sandbox](https://docs.ppio.ai/sandbox/filesystem/upload.md)
- [Download files from a sandbox](https://docs.ppio.ai/sandbox/filesystem/download.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.