Upload Files

Upload a single file

POST /v1/sandboxes/{id}/files

Multipart form upload. One file per request.

curl -X POST http://localhost:8000/v1/sandboxes/sb_abc123/files \
  -F "file=@main.py"

{
  "filename": "main.py"
}

POST /v1/sandboxes/{id}/upload

Upload a zip file containing your full project. Folder structure is preserved.

curl -X POST http://localhost:8000/v1/sandboxes/sb_abc123/upload \
  -F "file=@project.zip"

{
  "status": "uploaded"
}

{
  "status": "uploaded"
}

Zip from inside your project folder so the structure is preserved:

cd my_project && zip -r ../my_project.zip .

Do not zip the folder itself — zip the contents. Otherwise Petri extracts into a subfolder and paths will not resolve correctly.

Parameter	Type	Required	Description
`id`	string	Yes	Sandbox ID returned from create.