LiteSoup exposes agent endpoints on managed servers and a dashboard REST API.
The dashboard exposes a REST API at /api/*. All endpoints require authentication via JWT cookie (obtained by logging in through the web UI).
Login via POST /api/auth/login with { "email": "...", "password": "..." }. A JWT cookie is set automatically. All subsequent API calls include this cookie.
| Method | Path | Description |
|---|---|---|
| GET | /api/servers | List all servers |
| POST | /api/servers | Connect a server |
| PATCH | /api/servers/:id | Update server name/hostname/tags |
| GET | /api/servers/:id/sites | List sites on a server |
| POST | /api/servers/:id/sites | Create a new site |
| GET | /api/servers/:id/sites/:siteId | Get site detail |
| POST | /api/servers/:id/sync | Trigger server sync |
| POST | /api/servers/:id/wp-scan | Run WordPress scan |
| POST | /api/servers/:id/pool-apply | Apply pool tier config |
| GET | /api/activity | List activity log |
| GET | /api/settings | Get all settings |
| PUT | /api/settings/:key | Update a setting |
| GET | /api/pool-tiers | List pool tiers |
| PUT | /api/pool-tiers/:id | Update a pool tier |
Each server runs an agent that exposes HTTP endpoints on localhost (port 7777). The dashboard communicates with these endpoints to execute commands and collect metrics.
| Method | Path | Description |
|---|---|---|
| GET | /health | Agent liveness check |
| GET | /metrics | CPU, RAM, disk metrics |
| GET | /services | Systemd service statuses |
| GET | /sites | Discovered sites list |
| POST | /exec | Execute a CLI command (SSE stream) |
| POST | /sites/wp-scan | WordPress deep scan (SSE stream) |
| POST | /sites/db-password | Read DB password from wp-config.php |
The /exec endpoint accepts { "command": "site.create", "params": { ... } } and returns an SSE stream. Supported commands include site.create, site.delete, site.set-php, site.set-tier, site.set-tls, db.password, and pool.apply.
Servers can register with the dashboard automatically via a one-time token. Navigate to Servers > Connect server to generate a registration token. The server runs the agent which connects back to the dashboard.