Analyze — API reference
Custom dashboards, the metrics catalogue, and saved analyses.
0.16.6). Download the full spec at /docs/openapi.json.dashboards
GET /dashboards
List Dashboards
Details
Responses
| Status | Description |
|---|---|
200 | Successful Response |
POST /dashboards
Create Dashboard
Details
Request body (application/json) — required
Schema: object.
Responses
| Status | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |
GET /dashboards/by-slug/{slug}
Get Dashboard By Slug
Resolve a dashboard by its stable slug within the caller’s tenant.
Details
Parameters
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
slug | path | string | yes |
Responses
| Status | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |
GET /dashboards/favorites
List Favorites
The caller’s favorited dashboards.
Details
Responses
| Status | Description |
|---|---|
200 | Successful Response |
POST /dashboards/favorites/{dash_id}
Add Favorite
Details
Parameters
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
dash_id | path | string | yes |
Responses
| Status | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |
DELETE /dashboards/favorites/{dash_id}
Remove Favorite
Details
Parameters
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
dash_id | path | string | yes |
Responses
| Status | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |
GET /dashboards/{dash_id}
Get Dashboard
Details
Parameters
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
dash_id | path | string | yes |
Responses
| Status | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |
PATCH /dashboards/{dash_id}
Update Dashboard
Details
Parameters
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
dash_id | path | string | yes |
Request body (application/json) — required
Schema: object.
Responses
| Status | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |
DELETE /dashboards/{dash_id}
Delete Dashboard
Details
Parameters
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
dash_id | path | string | yes |
Responses
| Status | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |
POST /dashboards/{dash_id}/clone
Clone Dashboard
Deep-clone a dashboard the caller can see into a fresh private copy they own.
Details
Parameters
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
dash_id | path | string | yes |
Request body (application/json)
Schema: object.
Responses
| Status | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |
POST /dashboards/{dash_id}/widgets
Add Widget
Details
Parameters
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
dash_id | path | string | yes |
Request body (application/json) — required
Schema: object.
Responses
| Status | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |
POST /dashboards/{dash_id}/widgets/reorder
Reorder Widgets
Persist a new widget display order.
Details
Parameters
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
dash_id | path | string | yes |
Request body (application/json) — required
Schema: object.
Responses
| Status | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |
PATCH /dashboards/{dash_id}/widgets/{wid}
Update Widget
Details
Parameters
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
dash_id | path | string | yes | |
wid | path | string | yes |
Request body (application/json) — required
Schema: object.
Responses
| Status | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |
DELETE /dashboards/{dash_id}/widgets/{wid}
Delete Widget
Details
Parameters
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
dash_id | path | string | yes | |
wid | path | string | yes |
Responses
| Status | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |
POST /dashboards/{dash_id}/widgets/{wid}/clone
Clone Widget
Duplicate a widget within the same dashboard (config + color preserved).
Details
Parameters
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
dash_id | path | string | yes | |
wid | path | string | yes |
Responses
| Status | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |
GET /dashboards/{dash_id}/widgets/{wid}/data
Widget Data
Resolve a widget’s data LIVE via run_measure — the render-time data fetch.
Details
Parameters
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
dash_id | path | string | yes | |
wid | path | string | yes |
Responses
| Status | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |
GET /measures/catalogue
Measure Catalogue
The measure catalogue: each measure + the dimensions valid for it + the widget types.
Details
Responses
| Status | Description |
|---|---|
200 | Successful Response |
GET /measures/fields
Measures Fields
Discover dynamic, sliceable session.metadata.* keys for the current scope.
Details
Responses
| Status | Description |
|---|---|
200 | Successful Response |
analyses
POST /analyses/{name}/run
Run Analysis
Details
Parameters
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
name | path | string | yes |
Responses
| Status | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |