#4547·umami

Feature request: relative time ranges on stats endpoints (so static dashboards need no proxy)

Author: InfinifarCreated Sep 17, 2026Updated Sep 17, 2026

API keys in v3.4 (#4454) solved authentication for stateless dashboards — thank you.

One blocker remains for tools like Homepage (gethomepage.dev): GET /api/websites/{id}/stats still requires a dynamic startAt+endAt (or startDate+endDate). Such dashboards use static config URLs and cannot compute timestamps at request time, so they still require a sidecar proxy to render analytics.

Suggestion: accept a relative range parameter, e.g. ?period=24h (today, 7d, 30d), or default to a range when none is provided.

That would let a static dashboard do:

GET /api/websites/{id}/stats?period=24h    # Authorization: Bearer <api-key>