api reference

Visualizations

Chart/table configuration attached to a query, referenced by dashboard widgets.

POST/api/visualizations

Create a visualization on a query.

Request

{
  "query_id": 42,
  "type": "chart",
  "name": "Signups over time",
  "options": { "globalSeriesType": "line" }
}

Response

{
  "id": 71,
  "query_id": 42,
  "type": "chart",
  "name": "Signups over time",
  "description": null,
  "options": { "globalSeriesType": "line" },
  "created_at": "2026-07-17T12:00:00Z",
  "updated_at": "2026-07-17T12:00:00Z"
}

POST/api/visualizations/{id}

Update a visualization's type, name, description, or options.

Request

{ "options": { "globalSeriesType": "bar" } }

DELETE/api/visualizations/{id}

Delete a visualization. Returns 204.