# ProcessDashboard

The overview dashboard (`GET /processes/summary`).

**Kind:** an object, used in responses.

## Fields

Every field is present in a response; empty ones are `null`.

| Field | Type | Description |
|---|---|---|
| `windowStart` | `datetime` | UTC start of the first hour bucket. The window runs from here to now. |
| `hours` | `integer` | The number of hour buckets in the window. |
| `byType` | [`ProcessTypeStateCounts`](https://docs.maitento.com/reference/types/process-type-state-counts.md)`[]` | Run counts by state, one row per kind of run. |
| `activeRuns` | [`ProcessSummary`](https://docs.maitento.com/reference/types/process-summary.md)`[]` | Live runs (state Active or Waiting), newest first, at most 20. |
| `recentFailures` | [`ProcessSummary`](https://docs.maitento.com/reference/types/process-summary.md)`[]` | Runs created in the window that ended in Error, newest first, at most 10. |
| `throughput` | [`ProcessThroughputPoint`](https://docs.maitento.com/reference/types/process-throughput-point.md)`[]` | One point per hour per process type, zero-filled. |
| `tokens` | [`ProcessTokenPoint`](https://docs.maitento.com/reference/types/process-token-point.md)`[]` | One point per hour, zero-filled. |

## Example

```json
{
  "windowStart": "2026-10-26T12:00:00.0000000Z",
  "hours": 0,
  "byType": [
    {
      "type": "App",
      "active": 0,
      "waiting": 0,
      "finished": 0,
      "error": 0,
      "killed": 0
    }
  ],
  "activeRuns": [
    {
      "id": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "type": "App",
      "status": "...",
      "state": "Active",
      "definitionId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "definitionName": "...",
      "definitionVersion": 0,
      "namespaceId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "namespaceName": "...",
      "dateCreated": "2026-10-26T12:00:00.0000000Z",
      "dateStarted": "2026-10-26T12:00:00.0000000Z",
      "dateEnded": "2026-10-26T12:00:00.0000000Z",
      "dateUpdated": "2026-10-26T12:00:00.0000000Z",
      "executionTime": "00:05:00",
      "dateRunnerClaimed": "2026-10-26T12:00:00.0000000Z",
      "parentProcessId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "parentProcessType": "App",
      "rootProcessId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "userCreatedById": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "triggeredByAutomationId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "triggeredByAutomationName": "...",
      "failureSummary": "...",
      "awaitingHumanInput": false,
      "waitingForLaneSinceUtc": "2026-10-26T12:00:00.0000000Z",
      "tokens": {},
      "retentionLease": {},
      "retentionExpiresAtUtc": "2026-10-26T12:00:00.0000000Z"
    }
  ],
  "recentFailures": [
    {
      "id": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "type": "App",
      "status": "...",
      "state": "Active",
      "definitionId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "definitionName": "...",
      "definitionVersion": 0,
      "namespaceId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "namespaceName": "...",
      "dateCreated": "2026-10-26T12:00:00.0000000Z",
      "dateStarted": "2026-10-26T12:00:00.0000000Z",
      "dateEnded": "2026-10-26T12:00:00.0000000Z",
      "dateUpdated": "2026-10-26T12:00:00.0000000Z",
      "executionTime": "00:05:00",
      "dateRunnerClaimed": "2026-10-26T12:00:00.0000000Z",
      "parentProcessId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "parentProcessType": "App",
      "rootProcessId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "userCreatedById": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "triggeredByAutomationId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "triggeredByAutomationName": "...",
      "failureSummary": "...",
      "awaitingHumanInput": false,
      "waitingForLaneSinceUtc": "2026-10-26T12:00:00.0000000Z",
      "tokens": {},
      "retentionLease": {},
      "retentionExpiresAtUtc": "2026-10-26T12:00:00.0000000Z"
    }
  ],
  "throughput": [
    {
      "hourStart": "2026-10-26T12:00:00.0000000Z",
      "type": "App",
      "started": 0,
      "finished": 0,
      "failed": 0,
      "killed": 0
    }
  ],
  "tokens": [
    {
      "hourStart": "2026-10-26T12:00:00.0000000Z",
      "input": 0,
      "output": 0,
      "cacheRead": 0,
      "cacheWrite": 0,
      "reasoning": 0
    }
  ]
}
```

## Where it's used

- [`runs.summary`](https://docs.maitento.com/reference/api/runs.md) (`GET /processes/summary`)