File Operations

Each session has an isolated filesystem. Files are stored in a temp directory on the host, accessible to the WASM program via WASI preopens.

Write a File

POST /api/v1/sessions/:id/files

Request body:

{
  "path": "src/main.py",
  "content": "print('hello')"
}

Parent directories are created automatically. Paths are relative to the session root.

Response (200):

{
  "message": "Written: src/main.py"
}

GET /api/v1/sessions/:id/files?path=src/main.py

Response (200):

{
  "path": "src/main.py",
  "content": "print('hello')"
}

GET /api/v1/sessions/:id/files?path=/&list=true

Response (200):

{
  "path": "/",
  "entries": [
    { "name": "src", "is_dir": true, "size": 0 },
    { "name": "hello.wasm", "is_dir": false, "size": 1024 }
  ]
}

DELETE /api/v1/sessions/:id/files?path=src/main.py

Deletes files or directories (recursive for directories).

Response (200):

{
  "message": "Deleted: src/main.py"
}