dashboards

Get a single element.

Returns one element (type, title, grid position, data, spec, overrides) without round-tripping the whole dashboard spec. The response includes a themeContext map — the resolved values of every theme token the element references — so an agent can interpret the element in isolation (mcp-server-design.md §Token budget).

get/v1/dashboards/{id}/pages/{pageId}/elements/{elementId}

Request

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

Query parameters

include'provenance' | 'themeTokens'

Opt-in expansion. provenance adds the bounded provenance summary (createdBy / lastEdit / revisionCount); omitted by default so token-thrift readers (MCP dvt_element_get) do not receive actor identity. themeTokens adds resolvedTokens, the FULL resolved theme token map (the renderer's own palette) rather than the referenced subset in themeContext — needed by a caller that must reproduce the renderer's paint, e.g. the formatted-XLSX export's table header (DVT-4298); off by default for the same token-thrift reason.

Response

The element plus its resolved themeContext.

Example response

{
  "data": {
    "type": "chart:bar"
  }
}

Changes

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