dashboards

Stream Data

Changed on

Same results as /data, delivered per widget as each one finishes.

A dashboard is only as fast as its slowest widget when the whole payload has to be assembled first. Streaming lets the tiles that are ready render immediately, which is most of them: widget cost on a real dashboard varies by an order of magnitude.

Access is resolved once, up front — a viewer who may not see the dashboard gets a 404 before the stream opens, not an error event inside it.

get/api/v1/dashboards/{dashboard_id}/data/stream

Request

  • Base URL
    https://api.ninjavan.co (the document declares no server; this is the origin it was published from)
  • URL
    https://api.ninjavan.co/api/v1/dashboards/{dashboard_id}/data/stream
  • Auth
    none declared

Path parameters

dashboard_idinteger required

Query parameters

date_windowstring nullable

Narrow every widget to one period, overriding the dashboard's saved default.

widget_idsinteger[] nullable

Run only these widgets. The layout event then describes just the requested subset, so callers merge it into what they already hold rather than replacing their widget list.

Headers

authorizationstring nullable
X-API-Keystring nullable

Response

Successful Response

unknown required

Changes