Dashboard
A single endpoint that returns the aggregated agent, task, cost, approval, and run-activity metrics shown on the squad dashboard.
Prerequisites
- API key:
Authorization: Bearer <token> - Squad-scoped access
Endpoints
| Method | Path | Description |
|---|---|---|
GET | /api/squads/{squadId}/dashboard | Aggregated dashboard summary for the squad |
Squad summary
GET /api/squads/{squadId}/dashboard
Returns a point-in-time roll-up. Counts are computed live; cost figures cover the current calendar month (UTC) and run activity covers a rolling 14-day window.
Response
{
"squadId": "...",
"agents": { "active": 4, "running": 1, "paused": 0, "error": 0 },
"tasks": { "open": 12, "inProgress": 3, "blocked": 1, "done": 47 },
"costs": {
"monthSpendCents": 12600,
"monthBudgetCents": 50000,
"monthUtilizationPercent": 25.2
},
"pendingApprovals": 2,
"budgets": {
"activeIncidents": 0,
"pendingApprovals": 1,
"pausedAgents": 0,
"pausedProjects": 0
},
"runActivity": [
{ "date": "2026-06-09", "succeeded": 18, "failed": 2, "other": 1, "total": 21 }
]
}
Fields
| Field | Type | Description |
|---|---|---|
agents | object | Agent counts by operational state (active, running, paused, error). Idle agents count as active |
tasks | object | Issue counts: open, inProgress, blocked, done |
costs.monthSpendCents | integer | Spend so far this calendar month, in cents |
costs.monthBudgetCents | integer | Monthly squad budget ceiling, in cents |
costs.monthUtilizationPercent | number | Spend as a percentage of budget (0 when no budget is set) |
pendingApprovals | integer | Approvals awaiting an Operator decision |
budgets | object | Budget-governance counts: activeIncidents, pendingApprovals, pausedAgents, pausedProjects |
runActivity | array | Per-day Heartbeat run totals over the rolling 14-day window (succeeded, failed, other, total); timed-out runs count as failed |