Skip to content
Last updated

Reference Insights Model Endpoints

Use these REST endpoints to build and maintain Treasure Insights data models.

Create/Read/Delete Insights Models

Get a list of the account’s insights models

GET /reporting/datamodels

Get the build and query resource limit sizes

ElastiCube data model, build, and dashboard/queries are associated with a certain upper limit of RAM and CPU, an upper limit of 23 GB, so if the data model build exceeds that limit, users will see an error.

GET /reporting/account

Sample Response

View the query and dashboard limits in GB paying specific attention to the build_size and query_size parameters.

{
        "id": "10",
        "sisense_group_id": "5f7e73a8390cef002c916538",
        "td_account_id": "6233",
        "max_data_modelers": 5,
        "max_designers": 10,
        "max_viewers": 20,
        "storage_size": 20,
        "storage_threshold": 500,
        "build_threshold": 100,
        "query_threshold": 100,
        "sisense_datagroup_oid": "7e550d2c-68c0-4fb1-90b0-ac40c044b096",
        "sisense_hostname": "us01-01-development.reporting.treasuredata.com",
        "build_size": 23.0,
        "query_size": 23.0,
        "calculated_build_size": 23.0,
        "calculated_query_size": 23.0,
        "current_data_modelers": 4,
        "current_designers": 2,
        "current_viewers": 4
}

Retrieve a specific insights model configuration

GET /reporting/datamodels/{datamodel_id}

Create a new insights model

POST /reporting/datamodels

Delete an existing insights model

DELETE /reporting/datamodels/{datamodel_id}

Update Insights Model Share

Share the insights model with users

PUT /reporting/datamodels/{datamodel_id}/shares

Create/Read/Delete Datasets

Get a list of the datasets in the insights model

GET /reporting/datamodels/{datamodel_id}/datasets

Create a new insights model dataset

POST /reporting/datamodels/{datamodel_id}/datasets

Delete an insights model dataset

DELETE /reporting/datamodels/{datamodel_id}/datasets/{dataset_id}

Create/Read/Update/Delete Tables

Get a list of tables in a dataset

GET /reporting/datamodels/{datamodel_id}/datasets/{dataset_id}/tables

Create a new table in a dataset

POST /reporting/datamodels/{datamodel_id}/datasets/{dataset_id}/tables

Update an existing table in a dataset

PUT|PATCH /reporting/datamodels/{datamodel_id}/datasets/{dataset_id}/tables/{table_id}

Delete an existing table in a dataset

DELETE /reporting/datamodels/{datamodel_id}/datasets/{dataset_id}/tables/{table_id}

Create/Read/Delete Relations

Get a list of insights model relations

GET /reporting/datamodels/{datamodel_id}/relations

Create a new relation for an insights model

POST /reporting/datamodels/{datamodel_id}/relations

Delete an existing relation

DELETE /reporting/datamodels/{datamodel_id}/relations/{relation_id}

Create/Read/Delete Insights Model Builds

Get a list of insights model builds

GET /reporting/datamodels/{datamodel_id}/builds

Get the insights model’s build status

GET /reporting/datamodels/{datamodel_id}/builds/{build_id}

Trigger the build of an insights model

POST /reporting/datamodels/{datamodel_id}/builds

Stop the build of an insights model

DELETE /reporting/datamodels/{datamodel_id}/builds/{build_id}