ApiMeta
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.
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.
AuthorizationBearer <token>
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 } ], "frontier_readable": true, "as_of": "string"}