List Saved Analytics Charts

GET https://api.suger.cloud/ai/org/{orgId}/analytics/chart

Lists the organization's saved charts, newest first, a page at a time. A chart over a dataset the caller may not read is left out, as if there were none; every page but the last is full.

Parameters

NameInTypeRequiredDescription
orgId path string yes Organization ID
limit query integer no
cursor query string no

Responses

200 — A page of charts

Content-Type: application/json

Response fields:

FieldTypeRequiredDescription
data array<AnalyticsSavedChart> yes
nextCursor string or null yes
hasMore boolean yes

AnalyticsSavedChart fields:

FieldTypeRequiredDescription
id string yes
title string yes
description string yes
version integer yes
createdBy string or null yes
createdAt string yes
updatedAt string yes
query object no The chart's query; absent when the caller cannot read every dataset it reads.
chart AnalyticsChartConfig no

AnalyticsChartConfig fields:

FieldTypeRequiredDescription
type string no The chart type; without it, the type the result's shape asks for.
x string no
y object no The measure, or measures sharing one unit, to plot.
series string no A dimension output; each of its values is drawn as its own series.
size string no
value string no
path array<string> no
rows array<string> no
across array<string> no
columns array<string> no
labels object no Display names for outputs, by output name, each at most 200 characters; the model's labels otherwise.
values boolean no
top number no Keep the N largest series, slices or points; at most seven, or ten slices of a pie, whose eighth to tenth are steps of the gray, each named on its slice.
sort string no
highlight object no One series value, drawn in color while the rest are muted.
target number no A goal, in the measure's unit.
axis object no
stack object no Stack the parts end to end, or not; `percent` stacks a bar's parts as shares of its own total, its axis reading 0% to 100%.
smooth boolean no
step boolean no
horizontal boolean no
lines array<string> no
totals boolean no
scale string no
range array<—> no
trend boolean no
period string no The period a number over a time breakdown shows: `whole`, the newest whole period (the default), or `newest`, the newest period, marked partial while it is.
donut boolean no
show string no
bars array<string> no
search boolean no A table's search box, which keeps the rows a cell of which shows the text typed in it, in any case, and counts them.

400 — INVALID_REQUEST: the cursor is not valid

Content-Type: application/json · Schema: AnalyticsError

AnalyticsError fields:

FieldTypeRequiredDescription
error object yes

401 — No valid token

Content-Type: application/json · Schema: AiErrorResponse

AiErrorResponse fields:

FieldTypeRequiredDescription
error string yes Error message

403 — Not a member of the organization

Content-Type: application/json · Schema: AiErrorResponse

AiErrorResponse fields:

FieldTypeRequiredDescription
error string yes Error message

422 — INVALID_REQUEST: the query string is not valid

Content-Type: application/json · Schema: AnalyticsError

AnalyticsError fields:

FieldTypeRequiredDescription
error object yes

500 — ANALYTICS_UNAVAILABLE: an unexpected failure

Content-Type: application/json · Schema: AnalyticsError

AnalyticsError fields:

FieldTypeRequiredDescription
error object yes

503 — ANALYTICS_UNAVAILABLE: analytics is not configured or not ready

Content-Type: application/json · Schema: AnalyticsError

AnalyticsError fields:

FieldTypeRequiredDescription
error object yes

Example

Generated from this operation's schema. Values are placeholders — substitute your own ids, and set SUGER_TOKEN to a bearer token from the OAuth client-credentials exchange.

Request

curl -X GET 'https://api.suger.cloud/ai/org/{orgId}/analytics/chart' \
  -H "Authorization: Bearer $SUGER_TOKEN"

Response — 200

{
  "data": [
    {
      "id": "01H0000000000000000000",
      "title": "string",
      "description": "string",
      "version": 1,
      "createdBy": "string",
      "createdAt": "2026-01-31T12:00:00Z",
      "updatedAt": "2026-01-31T12:00:00Z",
      "query": {},
      "chart": {
        "type": "line",
        "x": "string",
        "y": "string",
        "series": "string",
        "size": "string",
        "value": "string",
        "path": [
          "string"
        ],
        "rows": [
          "string"
        ],
        "across": [
          "string"
        ],
        "columns": [
          "string"
        ],
        "labels": {},
        "values": true
      }
    }
  ],
  "nextCursor": "string",
  "hasMore": true
}

Error — 400

{
  "error": {
    "code": "string",
    "message": "string",
    "diagnostics": [
      {
        "code": "INVALID_QUERY",
        "path": [
          "string"
        ],
        "message": "string",
        "fix": "string",
        "suggestions": [
          "string"
        ]
      }
    ],
    "parameter": "string"
  }
}

View as Markdown · API reference overview

Spotted something wrong or out of date on this page? Tell us and we'll correct it.