Session Manager

https://api.allternit.com/api/sessions

Creating → Ready ↔ Running
             ↓
        Paused | Stopped | Error | Destroyed

curl -X POST https://api.allternit.com/api/sessions \
  -H 'content-type: application/json' \
  -d '{
    "spec": {
      "name": "research-session",
      "working_dir": "/workspace",
      "env_vars": {},
      "resources": {
        "cpu_cores": 2.0,
        "memory_mib": 2048,
        "disk_mib": 10240
      },
      "use_vm": false,
      "image": "default",
      "timeout_secs": 3600
    }
  }'

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "research-session",
  "status": "ready",
  "spec": {
    "working_dir": "/workspace",
    "use_vm": false,
    "image": "default",
    "timeout_secs": 3600
  },
  "created_at": "2026-08-13T19:00:00.000Z",
  "last_activity_at": "2026-08-13T19:00:00.000Z",
  "driver_handle_id": "hdl_1",
  "driver_type": "Process",
  "exit_code": null,
  "error_message": null
}

curl -X POST https://api.allternit.com/api/sessions/550e8400-e29b-41d4-a716-446655440000/exec \
  -H 'content-type: application/json' \
  -d '{
    "command": ["uname", "-a"],
    "env_vars": {},
    "timeout_ms": 30000
  }'

{
  "exit_code": 0,
  "stdout": "Darwin host 23.0.0 ...\n",
  "stderr": "",
  "duration_ms": 42
}

curl -X POST https://api.allternit.com/api/sessions/550e8400-e29b-41d4-a716-446655440000/destroy \
  -H 'content-type: application/json' \
  -d '{"force": false}'

{ "success": true }