Filesystem
Accessed via
sandbox.files.Ask AI about this page
await sandbox.files.read(path)
Read a file as a UTF-8 string. HTTP API →
body pathstrrequiredAbsolute path to the file
Returns:
strawait sandbox.files.read_bytes(path)
Read a file as raw bytes.
body pathstrrequiredAbsolute path to the file
Returns:
bytesawait sandbox.files.write(path, content)
Write content to a file. HTTP API →
body pathstrrequiredAbsolute path for the destination file
body contentstr | bytesrequiredFile content
Returns:
Noneawait sandbox.files.list(path="/")
List directory contents. HTTP API →
body pathstrdefault: /Directory path
Returns:
list[EntryInfo]await sandbox.files.make_dir(path)
Create a directory. HTTP API →
body pathstrrequiredDirectory path
Returns:
Noneawait sandbox.files.remove(path)
Delete a file or directory. HTTP API →
body pathstrrequiredPath to remove
Returns:
Noneawait sandbox.files.exists(path)
Check if a path exists. Client-side wrapper — attempts a read and returns
False on error.body pathstrrequiredPath to check
Returns:
boolawait sandbox.files.read_stream(path)
Stream a file as async byte chunks. Avoids buffering the full file in memory — ideal for large files (50MB+).
body pathstrrequiredAbsolute path to the file
Returns:
AsyncIterator[bytes]await sandbox.files.write_stream(path, stream)
Stream content to a file from an async iterator. Avoids buffering the full file in memory.
body pathstrrequiredAbsolute path for the destination file
body streamAsyncIterator[bytes]requiredAsync iterator yielding byte chunks
Returns:
NoneTypes
EntryInfo
python
123456@dataclass class EntryInfo: name: str is_dir: bool path: str size: int = 0