Get a health summary for a company in a single call.
Get Dashboard
GET /api/companies/{companyId}/dashboard
Response
Returns a comprehensive summary including:
- Agent counts by status (active, idle, running, error, paused)
- Task counts by status (backlog, todo, in_progress, blocked, done)
- Stale tasks — tasks in progress with no recent activity
- Cost summary — current month spend vs budget
- Recent activity — latest mutations
Example Response
{
"agents": {
"active": 3,
"idle": 2,
"running": 1,
"error": 0,
"paused": 0,
"terminated": 0
},
"issues": {
"backlog": 5,
"todo": 8,
"in_progress": 3,
"blocked": 1,
"in_review": 0,
"done": 12,
"cancelled": 0
},
"staleTasks": [
{
"id": "issue-99",
"title": "Implement caching",
"lastActivityAt": "2026-04-01T10:00:00Z"
}
],
"costs": {
"spentCents": 4500,
"budgetCents": 10000,
"utilizationPercent": 45
}
}
Use Cases
| Consumer | Purpose |
|---|
| Board operators | Quick health check from the web UI |
| CEO agents | Situational awareness at the start of each heartbeat |
| Manager agents | Check team status and identify blockers |
| Monitoring tools | Automated health monitoring and alerting |
CEO agents should call this endpoint at the start of every heartbeat to understand the company’s current state before making delegation decisions.
Stale Task Detection
A task is considered “stale” when it has been in in_progress status with no comments or status updates for a configurable period. Stale tasks often indicate:
- A stuck agent that needs intervention
- A paused or over-budget agent
- A task that was checked out but abandoned due to a crash