Gladex API & CLI Reference

GET /healthz PUBLIC

Lightweight health check. Returns JSON with service status, environment, timestamp, and version.

{
  "status": "ok",
  "service": "gladex-investor-app",
  "env": "prod",
  "timestamp": 1790039940,
  "version": "0.4.28"
}

GET /api/health PUBLIC

Detailed health check. Includes peer service status, disk usage, and unread message count.

{
  "status": "ok",
  "service": "gladex-investor-app",
  "env": "prod",
  "timestamp": 1790039940,
  "version": "0.4.28",
  "checks": {
    "investor-app-dev": "ok",
    "investor-app-prod": "self",
    "disk_usage_pct": 34.7,
    "disk_free_bytes": 68625489920,
    "unread_messages": 0
  }
}

GET /api/version PUBLIC

Returns application version, PHP version, and environment.

{
  "app": "gladex-investor-app",
  "version": "0.4.28",
  "php": "8.3.6",
  "env": "prod"
}

GET /download/gladex PUBLIC

Downloads the latest gladex CLI binary (Linux amd64). Use curl -O or wget.

curl -O https://gladex.de/download/gladex
chmod +x gladex
./gladex --help

GET /investor LAN

Investor chat UI. Threaded message view with agent-investor communication. Supports CMD+Enter send, 6h time filter, dark theme.

GET /api/messages LAN

Returns all messages as JSON array, ordered by timestamp.

{
  "messages": [
    {
      "id": 1,
      "ts": "1726812345",
      "direction": "investor_to_agent",
      "body": "Hello from investor!",
      "read": 1
    }
  ]
}

POST /api/messages LAN

Send a message from investor to agent. Body must be JSON with body field. Also appends to INBOX.md for agent pickup.

curl -X POST http://localhost:8001/api/messages \
  -H "Content-Type: application/json" \
  -d '{"body": "Build the landing page"}'

POST /api/messages/:id/read LAN

Mark a specific message as read by ID.

GET /api/status LAN

Returns unread investor message count.

{ "unread_investor_messages": 0 }

GET /budget LAN

Budget dashboard UI. Shows monthly allowance, spending, allocations, and rules.

GET /api/budget LAN

Returns parsed budget data from BUDGET.md as structured JSON.

{
  "month": "2026-09",
  "allowance": 5.00,
  "spent": 1.50,
  "remaining": 3.50,
  "allocations": ["gladex.de (1.50 EUR/mo)"],
  "rules": "..."
}

GET /trust LAN

Trust Dashboard UI. Shows AI tool confidence scores with summary grid, score list, and record form.

GET /api/trust LAN

Returns trust scores from the Go CLI workspace database.

{
  "scores": [
    {
      "source": "copilot",
      "target": "project-x",
      "score": 0.85,
      "level": "HIGH",
      "updated_at": "2026-09-21T20:00:00Z"
    }
  ],
  "summary": { "total": 3, "high": 1, "medium": 1, "neutral": 0, "low": 1 }
}

POST /api/trust/record LAN

Record a trust outcome via the Go CLI. Body: {"source": "...", "target": "...", "outcome": "accepted|rejected|partial"}

GET /changelog LAN

Changelog page. Renders CHANGELOG.md with dark theme, version tags, and section labels.

┌─────────────────────────────────────────────────┐
│                  DNS (PowerDNS API)               │
│  gladex.de ──→ 77.90.15.49 (VPS)                 │
│  dev / git / info / stats subdomains              │
└────────────────────┬────────────────────────────┘
                     │ WireGuard (10.2.3.0/24)
┌────────────────────▼────────────────────────────┐
│                 Apache (TLS)                      │
│  :80 → 301 HTTPS │ :443 → reverse proxy          │
│  Let's Encrypt cert (auto-renewal)               │
└──────┬──────────────────────────┬───────────────┘
       │                          │
  ┌────▼────┐              ┌──────▼──────┐
  │  :8000  │              │    :8001    │
  │  DEV    │              │    PROD     │
  │ PHP 8.3 │              │  PHP 8.3   │
  │ SQLite  │              │  SQLite    │
  └─────────┘              └────────────┘
       │                          │
  ┌────▼──────────────────────────▼──────┐
  │          Go CLI (gladex v0.4.28)       │
  │  Context · Workflow · Trust · MCP     │
  │  130+ unit tests                      │
  └──────────────────────────────────────┘