---
title: "Live update stream contract -- read-only readiness evidence"
method: GET
path: "/api/dashboard/live-update-stream-contract"
tags: ["Dashboard API"]
---

# Live update stream contract -- read-only readiness evidence

`GET /api/dashboard/live-update-stream-contract`

## Request

- Base URL: `https://api.cernion.de`
- URL: `https://api.cernion.de/api/dashboard/live-update-stream-contract`
- Auth: none declared

Returns a deterministic read-only contract/readiness view for proposed UI live-update channels. The endpoint describes stream kind, tenant/auth boundary, source service/action, current availability, fallback polling path, heartbeat/resume expectation, owner, blockers, gaps and side-effect guards. It does not open SSE/WebSocket connections, subscribe to channels, emit events, create auth modes, call external connectors, mutate domain state or add Personal-Agent shortcuts.

## Query parameters

- `domains` string
- `channels` string
- `sourceService` string
- `sourceAction` string
- `uiSurface` string
- `authBoundary` string
- `requiresResume` boolean
- `fallbackPollingPath` string
- `heartbeatSeconds` number
- `ownerRole` string
- `availability` string
- `includeUnsupportedSample` boolean
- `token` string

## Response `200`

Read-only live-update contract readiness view

- object
  - `capabilityKey` string
  - `safety` string
  - `status` string
  - `channelCount` number
  - `channels` unknown[]
    - unknown
  - `missingEvidence` unknown[]
    - unknown
  - `positiveFollowUps` unknown[]
    - unknown
  - `sourceActions` object
  - `dossierEvidence` object
  - `_errors` unknown[]
    - unknown
  - `timestamp` string, date-time

---

[API](https://skmtc.dev/cernion/apis/cernion-energy-tools-api.md) · [All operations](https://skmtc.dev/cernion/apis/cernion-energy-tools-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cernion/apis/cernion-energy-tools-api/revisions/cdb94473b538?raw)