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
| Name | In | Type | Required | Description |
|---|---|---|---|---|
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:
| Field | Type | Required | Description |
|---|---|---|---|
data | array<AnalyticsSavedChart> | yes | |
nextCursor | string or null | yes | |
hasMore | boolean | yes |
AnalyticsSavedChart fields:
| Field | Type | Required | Description |
|---|---|---|---|
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:
| Field | Type | Required | Description |
|---|---|---|---|
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:
| Field | Type | Required | Description |
|---|---|---|---|
error | object | yes |
401 — No valid token
Content-Type: application/json · Schema: AiErrorResponse
AiErrorResponse fields:
| Field | Type | Required | Description |
|---|---|---|---|
error | string | yes | Error message |
403 — Not a member of the organization
Content-Type: application/json · Schema: AiErrorResponse
AiErrorResponse fields:
| Field | Type | Required | Description |
|---|---|---|---|
error | string | yes | Error message |
422 — INVALID_REQUEST: the query string is not valid
Content-Type: application/json · Schema: AnalyticsError
AnalyticsError fields:
| Field | Type | Required | Description |
|---|---|---|---|
error | object | yes |
500 — ANALYTICS_UNAVAILABLE: an unexpected failure
Content-Type: application/json · Schema: AnalyticsError
AnalyticsError fields:
| Field | Type | Required | Description |
|---|---|---|---|
error | object | yes |
503 — ANALYTICS_UNAVAILABLE: analytics is not configured or not ready
Content-Type: application/json · Schema: AnalyticsError
AnalyticsError fields:
| Field | Type | Required | Description |
|---|---|---|---|
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.