---
title: "Evidence freshness guard -- read-only VNB signal metadata classification"
method: GET
path: "/api/dashboard-api/evidence-freshness-guard"
tags: ["Dashboard API"]
---

# Evidence freshness guard -- read-only VNB signal metadata classification

`GET /api/dashboard-api/evidence-freshness-guard`

## Request

- Base URL: `https://api.cernion.de`
- URL: `https://api.cernion.de/api/dashboard-api/evidence-freshness-guard`
- Auth: none declared

Classifies caller-supplied operational signal metadata into dossier-safe freshness and delta states. The endpoint returns staleness, known-anchor, new-delta, escalation recommendation, non-escalation reason, evidence gaps and positive follow-ups. It does not ingest email, Teams, calendar, monitoring or task data; does not create ACF cards, HITL tasks, tickets, workflow actions, billing/settlement/tariff/MaKo/device-control side effects; and does not add Personal-Agent shortcuts.

## Query parameters

- `signalId` string
- `sourceKind` string
- `sourceTimestamp` string
- `receivedTimestamp` string
- `lastSeenTimestamp` string
- `processArea` string
- `owner` string
- `dueDate` string
- `knownSnapshotId` string
- `knownSnapshotHash` string
- `currentSnapshotId` string
- `currentSnapshotHash` string
- `severityHint` string
- `blockedDecision` string
- `escalationThresholdDays` number
- `token` string

## Response `200`

Read-only evidence freshness classification

- object
  - `capabilityKey` string
  - `safety` string
  - `freshnessState` string
  - `deltaState` string
  - `escalationRecommended` boolean
  - `evidenceGaps` unknown[]
    - unknown
  - `positiveFollowUps` unknown[]
    - unknown
  - `sourceActions` object
  - `dossierEvidence` object
  - `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)