PalveronPalveronDocs

Command Center

Single endpoint that powers the entire Command Center dashboard.

The Command Center bundles every dashboard widget into one cacheable response. Build custom dashboards on top of it without making twenty separate calls.

GET /api/v1/command-center

GET /api/v1/command-center?range=24h
QueryDefaultValues
range24h1h, 6h, 24h, 7d, 30d

The parameter is named range — not time_range. Unknown query keys are ignored, so a time_range= parameter silently falls back to the 24h default window.

Recommended polling interval: 30 seconds.

Response shape

{
  "range": "24h",
  "kpis": {
    "governance_score": 87,
    "traces":        { "value": 12384, "delta": 4.2 },
    "interceptions": { "value": 231,   "delta": -0.6 },
    "proofs":        { "value": 1042,  "delta": 1.1 }
  },
  "timeline":     [ { "label": "14:00", "allow": 412, "block": 7, "flag": 21, "total": 440 } ],
  "top_policies": [ { "name": "PII Mask", "hits": 84, "color": "#..." } ],
  "agents": {
    "total": 12,
    "distribution": [ { "id": "ckagent...", "name": "Support Bot", "requests_today": 4012 } ],
    "top_agents": [ "…" ],
    "anomalies": [ "…" ]
  },
  "mcp": {
    "tool_calls": 320, "blocked": 4,
    "servers_total": 3, "servers_active": 3, "servers_error": 0,
    "pending_approvals": 1, "poisoning_suspects": 0
  },
  "costs": {
    "daily_estimate_eur": 18.42, "monthly_requests": 12384,
    "monthly_base_fee": 0, "overage_cost": 0, "total_estimate_eur": 18.42
  },
  "contract": {
    "included_requests": 50000, "used_requests": 12384,
    "utilization_percent": 24.7, "overage": 0
  },
  "live_feed":    [ "…" ],
  "action_items": [ "…" ],
  "content_types": [ { "content_type": "text", "count": 12000, "color": "#..." } ]
}

KPI counters carry a delta relative to the previous comparable window.

Use cases

  • Replace dashboard widgets one at a time without re-architecting — every widget consumes the same payload.
  • Drive on-call dashboards (Grafana, Datadog) by ingesting this endpoint as a custom data source.
  • Feed action_items[] into a daily compliance email digest.

For raw historical analytics (e.g., monthly compliance reports), prefer GET /api/v1/traces or GET /api/v1/export — Command Center is optimized for live dashboards, not bulk export.

On this page