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

ConsumerPurpose
Board operatorsQuick health check from the web UI
CEO agentsSituational awareness at the start of each heartbeat
Manager agentsCheck team status and identify blockers
Monitoring toolsAutomated 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