Analyze — API reference

Custom dashboards, the metrics catalogue, and saved analyses.

Generated from the live OpenAPI schema (version 0.16.6). Download the full spec at /docs/openapi.json.

dashboards

GET /dashboards

List Dashboards

Details

Responses

StatusDescription
200Successful Response

POST /dashboards

Create Dashboard

Details

Request body (application/json) — required

Schema: object.

Responses

StatusDescription
200Successful Response
422Validation Error

GET /dashboards/by-slug/{slug}

Get Dashboard By Slug

Resolve a dashboard by its stable slug within the caller’s tenant.

Details

Parameters

ParameterInTypeRequiredDescription
slugpathstringyes

Responses

StatusDescription
200Successful Response
422Validation Error

GET /dashboards/favorites

List Favorites

The caller’s favorited dashboards.

Details

Responses

StatusDescription
200Successful Response

POST /dashboards/favorites/{dash_id}

Add Favorite

Details

Parameters

ParameterInTypeRequiredDescription
dash_idpathstringyes

Responses

StatusDescription
200Successful Response
422Validation Error

DELETE /dashboards/favorites/{dash_id}

Remove Favorite

Details

Parameters

ParameterInTypeRequiredDescription
dash_idpathstringyes

Responses

StatusDescription
200Successful Response
422Validation Error

GET /dashboards/{dash_id}

Get Dashboard

Details

Parameters

ParameterInTypeRequiredDescription
dash_idpathstringyes

Responses

StatusDescription
200Successful Response
422Validation Error

PATCH /dashboards/{dash_id}

Update Dashboard

Details

Parameters

ParameterInTypeRequiredDescription
dash_idpathstringyes

Request body (application/json) — required

Schema: object.

Responses

StatusDescription
200Successful Response
422Validation Error

DELETE /dashboards/{dash_id}

Delete Dashboard

Details

Parameters

ParameterInTypeRequiredDescription
dash_idpathstringyes

Responses

StatusDescription
200Successful Response
422Validation 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

ParameterInTypeRequiredDescription
dash_idpathstringyes

Request body (application/json)

Schema: object.

Responses

StatusDescription
200Successful Response
422Validation Error

POST /dashboards/{dash_id}/widgets

Add Widget

Details

Parameters

ParameterInTypeRequiredDescription
dash_idpathstringyes

Request body (application/json) — required

Schema: object.

Responses

StatusDescription
200Successful Response
422Validation Error

POST /dashboards/{dash_id}/widgets/reorder

Reorder Widgets

Persist a new widget display order.

Details

Parameters

ParameterInTypeRequiredDescription
dash_idpathstringyes

Request body (application/json) — required

Schema: object.

Responses

StatusDescription
200Successful Response
422Validation Error

PATCH /dashboards/{dash_id}/widgets/{wid}

Update Widget

Details

Parameters

ParameterInTypeRequiredDescription
dash_idpathstringyes
widpathstringyes

Request body (application/json) — required

Schema: object.

Responses

StatusDescription
200Successful Response
422Validation Error

DELETE /dashboards/{dash_id}/widgets/{wid}

Delete Widget

Details

Parameters

ParameterInTypeRequiredDescription
dash_idpathstringyes
widpathstringyes

Responses

StatusDescription
200Successful Response
422Validation Error

POST /dashboards/{dash_id}/widgets/{wid}/clone

Clone Widget

Duplicate a widget within the same dashboard (config + color preserved).

Details

Parameters

ParameterInTypeRequiredDescription
dash_idpathstringyes
widpathstringyes

Responses

StatusDescription
200Successful Response
422Validation 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

ParameterInTypeRequiredDescription
dash_idpathstringyes
widpathstringyes

Responses

StatusDescription
200Successful Response
422Validation Error

GET /measures/catalogue

Measure Catalogue

The measure catalogue: each measure + the dimensions valid for it + the widget types.

Details

Responses

StatusDescription
200Successful Response

GET /measures/fields

Measures Fields

Discover dynamic, sliceable session.metadata.* keys for the current scope.

Details

Responses

StatusDescription
200Successful Response

analyses

POST /analyses/{name}/run

Run Analysis

Details

Parameters

ParameterInTypeRequiredDescription
namepathstringyes

Responses

StatusDescription
200Successful Response
422Validation Error