API Reference

POST /api/login
Content-Type: application/json
 
{
  "password": "your-password"
}

{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}

curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://your-dashboard.com:9000/hosts

GET /health

{
  "status": "ok",
  "hosts": 5,
  "connectedHosts": 3
}

GET /hosts

[
  {
    "id": "host-abc123",
    "name": "Production Server",
    "hostname": "prod-01",
    "ipAddress": "192.168.1.100",
    "openclawVersion": "2026.3.2",
    "openclawInstalled": true,
    "status": "connected",
    "lastSeen": "2026-03-10T00:30:00Z"
  }
]

GET /hosts/:id

GET /hosts/:id/metrics?hours=24

[
  {
    "timestamp": 1710028200000,
    "cpu_load": 0.5,
    "memory_used": 4294967296,
    "memory_total": 8589934592,
    "load_1m": 0.5,
    "load_5m": 0.4,
    "load_15m": 0.3
  }
]

POST /hosts/:id/command
Content-Type: application/json

{
  "type": "gateway_status"
}

POST /invite

{
  "code": "ABC123XY",
  "expiresAt": "2026-03-11T00:30:00Z"
}

const ws = new WebSocket('wss://your-dashboard.com/ws?dashboard=true');
 
ws.onmessage = (event) => {
  const { event: eventType, data } = JSON.parse(event.data);
  
  switch (eventType) {
    case 'host_connected':
      console.log('Host connected:', data);
      break;
    case 'host_disconnected':
      console.log('Host disconnected:', data);
      break;
    case 'host_updated':
      console.log('Host updated:', data);
      break;
  }
};