lineage

This dashboard's table-level lineage.

Returns the dashboard's current table-level lineage — the (panel, referenced table) edges C1's staleness sweep extracts via sqlglot on each panel's SQL (source: sql_parse). Requires dashboard read access on this dashboard (a non-reader gets 404, same as GET /v1/dashboards/{id}).

status is "pending" (not 404, not an error) when the dashboard has never been through an extraction pass yet — a brand-new dashboard, or one the staleness sweep hasn't reached — "ok"/"partial"/"error" once it has ("partial" means at least one panel had a non-fatal issue, surfaced in warnings; "error" means the last attempt could not reach the extraction engine at all — prior edges, if any, are left untouched, not cleared).

LOAD-BEARING: each edge's resolvedObjectId is re-resolved against the synced catalog (A3) at READ TIME, on every call — it is never read back from storage. catalog_objects.id is re-minted on every catalog sync pass, so a persisted resolution would silently dangle after the very next sync; resolvedObjectId is null whenever the table isn't (or isn't yet) resolvable, which is a normal outcome, not an error.

BOUNDED: edges is capped at 500 edges — a deterministic safety bound, not a paginator (the cut is taken after a stable sort, so the same dashboard always yields the same 500). There is no paging parameter and no cursor; a response holding exactly 500 edges means there may be more that were never returned, and the true total is unknown.

get/v1/dashboards/{id}/lineage

Request

  • Base URL: http://localhost:8080
  • URL: http://localhost:8080/v1/dashboards/{id}/lineage
  • Auth: one of:
    • API key in cookie dvt_session
    • HTTP bearer

Response

The dashboard's current lineage.

Changes

No recorded changes to this operation across all 1 revision of this API.