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?time_range=24h| Query | Default | Values |
|---|---|---|
time_range | 24h | 1h, 24h, 7d, 30d |
Recommended polling interval: 30 seconds. The endpoint is rate-limited per project independently of the regular quota.
Response shape
{
"kpis": {
"total_requests": { "value": 12384, "delta_pct": 4.2 },
"blocked_rate": { "value": 0.018, "delta_pct": -0.6 },
"modified_rate": { "value": 0.041, "delta_pct": 1.1 },
"pending_approvals": { "value": 3, "delta_pct": 0 }
},
"timeline": [ { "ts": "...", "passed": 412, "blocked": 7, "modified": 21 } ],
"top_policies": [ { "id": "pol_...", "name": "PII Mask", "triggers": 84 } ],
"agent_distribution": [ { "agent_id": "agent_...", "name": "Support Bot", "requests": 4012 } ],
"cost": { "total_eur": 18.42, "by_model": [ ... ] },
"contract_usage": { "consumed": 12384, "limit": 50000, "pct": 0.247 },
"live_feed": [ { "trace_id": "...", "decision": "BLOCKED", "ts": "..." } ],
"action_needed": [ { "type": "fria_due", "agent_id": "agent_...", "due_at": "..." } ]
}All counters include delta_pct relative to the previous comparable window (24h vs. previous 24h, 7d vs. previous 7d).
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_needed[]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.