Query Chart Endpoint

Request payload for POST /charts/{name}/query.

A chart is a plot, not a table — it can never paginate (apps.catalog .registry.validate_charts_against_datasets refuses a chart declared over a paginated=True dataset), so page/size are absent here rather than accepted-and-ignored the way DatasetQueryRequest treats them for a non-paginated dataset.

sort IS accepted: a categorical-x chart (e.g. a ranked bar chart) is legitimately re-ranked by a client-supplied sort — there the sort key determines the ranking, not just the display order. A sort that would scramble a TEMPORAL x-axis is refused, but not by this model — that check needs the chart's x column and its declared type, which live in the catalog, not the request. See apps.api.charts._reject_axis_breaking_sort.

A chart query response: its descriptor plus a chart-shaped result.

columns is list[ChartColumn], not list[ColumnDescriptor] — a chart plots values, it never renders a table, so it does not carry the table-only affordances (sortable/filterable/edit/link/...) a ColumnDescriptor has. meta is ChartMeta, not DatasetMeta, for the same reason: see that class's docstring for why pagination and dataset fields do not belong here.