GET /v1/meta/freshness
The freshness frontier: for every served surface, the exact block (or observation time) it currently reflects, its anchor class (block/time/slot/cohort), and its staleness budget. One call replaces per-widget staleness folklore. A registered surface with no stamp yet is status:"unmeasured" — absence never means fresh. Each surface also carries its SLO (class, 7-day attainment target, the attainment measured before the target was set) and its state: fresh, paused (its job is deliberately waiting behind a nightly recompute — the age shown is still the real age), stale (a stall), overrun (paused longer than ever measured) or unmeasured.
The freshness frontier: for every served surface, the exact block (or observation time) it currently reflects, its anchor class (block/time/slot/cohort), and its staleness budget. One call replaces per-widget staleness folklore. A registered surface with no stamp yet is status:"unmeasured" — absence never means fresh. Each surface also carries its SLO (class, 7-day attainment target, the attainment measured before the target was set) and its state: fresh, paused (its job is deliberately waiting behind a nightly recompute — the age shown is still the real age), stale (a stall), overrun (paused longer than ever measured) or unmeasured.
API key: Authorization: Bearer pk_live_… (mint at polyrank.app/api-keys)
In: header
Response Body
application/json
curl -X GET "https://example.com/v1/meta/freshness"{ "surfaces": [ { "surface": "string", "anchor": "block", "label": "string", "source_jobs": [ "string" ], "budget_seconds": 0, "status": "measured", "as_of_block": "string", "as_of_time": "string", "input_frontier": "string", "input_surface": "string", "source_job": "string", "updated_at": "string", "age_seconds": 0, "slo_class": "chain", "slo_target": 0, "state": "fresh", "state_reason": "string", "yield_since": "string", "yield_ceiling_seconds": 0, "provisional": "string", "availability": "ok", "availability_rows": 0, "availability_tables": [ "string" ], "measured": { "within_slo": 0, "within_budget": 0, "p50_seconds": 0, "p99_seconds": 0, "max_seconds": 0, "method": "state_gauge" } } ], "frontier_readable": true, "as_of": "string", "slo_classes": [ { "slo_class": "string", "label": "string", "surfaces": [ "string" ], "budget_seconds": 0, "slo_target": 0, "provisional": true, "has_yields": true } ], "slo_evidence": { "measured_from": "string", "measured_through": "string", "source": "string" }, "yields_readable": true, "availability_readable": true}