API Reference

POST /api/auth/login
Content-Type: application/json

{
  "email": "admin@example.com",
  "password": "your-password"
}

{
  "user": { "id": 1, "email": "admin@example.com", "name": "Admin" }
}

{
  "error": "Unauthorized",
  "message": "Invalid email or password"
}

GET /api/servers

{
  "servers": [{
    "id": 1, "name": "JP-1", "hostname": "jp1.codetot.org",
    "port": 22, "user": "root", "tags": ["production"],
    "os": "Ubuntu 24.04", "version": "0.9.0",
    "sites_count": 3, "last_sync": "2026-07-14T07:30:00Z"
  }]
}

{ "error": "Unauthorized" }

POST /api/servers
Content-Type: application/json

{
  "name": "SG-1", "hostname": "sg1.example.com",
  "port": 2222, "user": "root", "tags": ["staging"]
}

{
  "server": { "id": 2, "name": "SG-1", "status": "pending" }
}

{
  "error": "Validation failed",
  "fields": { "hostname": ["The hostname field is required."] }
}

GET /api/servers/1

{
  "server": {
    "id": 1, "name": "JP-1", "hostname": "jp1.codetot.org",
    "port": 22, "tags": ["production"],
    "os": "Ubuntu 24.04", "version": "0.9.0", "sites_count": 3,
    "metrics": { "cpu": 23.5, "ram": { "used": 2048, "total": 8192, "unit": "MB" } }
  }
}

{
  "error": "Not found",
  "message": "Server with id 99 not found"
}

PATCH /api/servers/1
Content-Type: application/json

{ "name": "Tokyo-Prod-1", "tags": ["production"] }

{
  "server": { "id": 1, "name": "Tokyo-Prod-1", "tags": ["production"] }
}

{ "error": "Not found", "message": "Server not found" }

GET /api/servers/1/sites

{
  "sites": [{
    "id": 1, "domain": "example.com", "user": "litesoup",
    "php": "8.2", "tier": "small", "tls": "letsencrypt", "wp_version": "6.7",
    "updates": { "plugins": 2, "themes": 1, "core": false }
  }]
}

{ "error": "Not found", "message": "Server not found" }

POST /api/servers/1/sites
Content-Type: application/json

{
  "domain": "newsite.com", "php": "8.3",
  "tier": "medium", "tls": "letsencrypt",
  "email": "admin@example.com"
}

{
  "site": { "id": 2, "domain": "newsite.com", "status": "provisioning" }
}

{
  "error": "Validation failed",
  "fields": { "domain": ["The domain has already been taken."] }
}

GET /api/servers/1/sites/1

{
  "site": {
    "id": 1, "domain": "example.com", "user": "litesoup",
    "docroot": "/home/litesoup/webapps/example.com",
    "php": "8.2", "tier": "small", "tls": "letsencrypt",
    "framework": "wordpress", "wp_version": "6.7",
    "db_name": "wp_example_com", "created_at": "2026-07-14T07:00:00Z"
  }
}

{ "error": "Not found", "message": "Site not found on this server" }

POST /api/servers/1/sync

event: log
data: {"message": "Syncing..."}\nevent: complete
data: {"status": "ok", "sites": 3}

{ "error": "Agent offline", "message": "Agent not reachable" }

POST /api/servers/1/wp-scan
Content-Type: application/json
{ "site_id": 1 }

event: log
data: {"message": "Scanning..."}\nevent: complete
data: {"wp_version": "6.7", "plugins": 12}

{ "error": "Not found", "message": "Site not found" }

POST /api/servers/1/pool-apply
Content-Type: application/json
{ "user": "litesoup", "php_version": "8.2", "tier": "medium" }

{ "status": "ok", "message": "Pool updated to tier medium" }

{
  "error": "Validation failed",
  "fields": { "tier": ["Tier must be: small, medium, large"] }
}

GET /api/activity?limit=10

{
  "activities": [{ "id": 42, "type": "site.create", "domain": "newsite.com", "status": "success", "created_at": "2026-07-14T07:30:00Z" }],
  "total": 156
}

{ "error": "Unauthorized" }

GET /api/settings

{
  "settings": { "default_php": "8.2", "sync_interval": 300, "email_notifications": true }
}

{ "error": "Unauthorized" }

PUT /api/settings/sync_interval
Content-Type: application/json
{ "value": 600 }

{ "key": "sync_interval", "value": 600, "updated": true }

{
  "error": "Validation failed",
  "fields": { "value": ["Must be a positive integer"] }
}

POST /exec
Content-Type: application/json
{ "command": "site.create", "params": { "domain": "newsite.com", "php": "8.3" } }

event: log
data: {"message": "Creating..."}\nevent: complete
data: {"status": "ok", "domain": "newsite.com"}

{ "error": "Bad request", "message": "Unknown command: site.invalid" }

POST /sites/db-password
Content-Type: application/json
{ "domain": "example.com" }

{ "password": "aB3x...K9m2" }

{ "error": "Not found", "message": "Site example.com not found" }