VM Sessions API

https://api.allternit.com/vm-session

POST /vm-session

{
  "workdir": "/Users/dev/project",
  "env": { "API_KEY": "secret" },
  "network_enabled": true,
  "cpu_cores": 2,
  "memory_mb": 4096,
  "git_remote": "https://github.com/allternit/project",
  "git_branch": "main",
  "ssh_key_b64": null,
  "extra_packages": ["htop"],
  "skip_bootstrap": false,
  "exa_api_key": null,
  "gizzi_server_url": "http://192.168.64.1:3000",
  "config_dir": "/Users/dev/.gizzi",
  "extra_env": { "NODE_ENV": "development" }
}

{
  "session_id": "vm_2f8a9c4e5d3b",
  "status": "running",
  "workspace_path": "/workspace",
  "vm_backed": true,
  "git_cloned": true,
  "bootstrap_log": "[gizzi-bootstrap] Bootstrap complete ..."
}

GET /vm-session/vm_2f8a9c4e5d3b

{
  "id": "vm_2f8a9c4e5d3b",
  "created_at": "2026-08-13T10:00:00Z",
  "last_used": "2026-08-13T10:05:00Z",
  "workdir": "/Users/dev/project",
  "workspace_path": "/workspace",
  "status": "running",
  "git_cloned": true
}

POST /vm-session/vm_2f8a9c4e5d3b/execute

{
  "command": "cargo test",
  "env": { "RUST_BACKTRACE": "1" },
  "timeout_secs": 300,
  "workdir": null
}

{
  "exit_code": 0,
  "stdout": "running 10 tests\n...",
  "stderr": "",
  "duration_ms": 15420,
  "vm_backed": true
}

DELETE /vm-session/vm_2f8a9c4e5d3b

{
  "destroyed": true,
  "session_id": "vm_2f8a9c4e5d3b"
}