Skip to main content
Upload a file to the sandbox filesystem.

Basic Usage

from gravixlayer import GravixLayer

client = GravixLayer(api_key="YOUR_API_KEY")

sandbox = client.sandbox.sandboxes.create(template="python-base-v1", timeout=300)
sid = sandbox.sandbox_id

# Upload using write (multipart)
client.sandbox.sandboxes.write(
    sid,
    path="/home/user/uploaded_file.txt",
    data="Hello from uploaded file!",
)

Parameters

ParameterTypeRequiredDescription
sandbox_idstringYesSandbox ID
pathstringYesDestination path in sandbox
datastring/bytesYesFile content to upload

Batch Upload

Upload multiple files in a single request:
from gravixlayer.types.sandbox import WriteEntry

entries = [
    WriteEntry(path="/home/user/README.md", data="# My Project"),
    WriteEntry(path="/home/user/run.sh", data="#!/bin/bash\npython main.py", mode=0o755),
]

result = client.sandbox.sandboxes.write_files(sid, entries=entries)
print(f"Uploaded {len(result.files)} files")

Supported File Types

  • Text files: .txt, .csv, .json, .xml
  • Images: .png, .jpg, .gif, .svg
  • Documents: .pdf, .docx, .xlsx
  • Code files: .py, .js, .html, .css
  • Archives: .zip, .tar.gz

Next Steps

List Files

View uploaded files

Read File

Read uploaded file contents

Download File

Download files from sandbox

Run Python Code

Process uploaded files with code