{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"redocly_category":"Products","product_name":"Treasure Insights","type":"markdown"},"seo":{"title":"Reference Insights Model Endpoints","description":"Treasure Data Product Documentation · Collect and Unify · Segment and Activate · Experiment and Analyze · Decisioning Automate with AI Scale and Trust.","siteUrl":"https://docs.treasuredata.com","lang":"en-US","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"reference-insights-model-endpoints","__idx":0},"children":["Reference Insights Model Endpoints"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use these REST endpoints to build and maintain Treasure Insights data models."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#createreaddelete-insights-models"},"children":["Create/Read/Delete Insights Models"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#get-a-list-of-the-accounts-insights-models"},"children":["Get a list of the account’s insights models"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#get-the-build-and-query-resource-limit-sizes"},"children":["Get the build and query resource limit sizes"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#retrieve-a-specific-insights-model-configuration"},"children":["Retrieve a specific insights model configuration"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#create-a-new-insights-model"},"children":["Create a new insights model"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#delete-an-existing-insights-model"},"children":["Delete an existing insights model"]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#update-insights-model-share"},"children":["Update Insights Model Share"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#share-the-insights-model-with-users"},"children":["Share the insights model with users"]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#createreaddelete-datasets"},"children":["Create/Read/Delete Datasets"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#get-a-list-of-the-datasets-in-the-insights-model"},"children":["Get a list of the datasets in the insights model"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#create-a-new-insights-model-dataset"},"children":["Create a new insights model dataset"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#delete-an-insights-model-dataset"},"children":["Delete an insights model dataset"]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#createreadupdatedelete-tables"},"children":["Create/Read/Update/Delete Tables"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#get-a-list-of-tables-in-a-dataset"},"children":["Get a list of tables in a dataset"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#create-a-new-table-in-a-dataset"},"children":["Create a new table in a dataset"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#update-an-existing-table-in-a-dataset"},"children":["Update an existing table in a dataset"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#delete-an-existing-table-in-a-dataset"},"children":["Delete an existing table in a dataset"]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#createreaddelete-relations"},"children":["Create/Read/Delete Relations"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#get-a-list-of-insights-model-relations"},"children":["Get a list of insights model relations"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#create-a-new-relation-for-an-insights-model"},"children":["Create a new relation for an insights model"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#delete-an-existing-relation"},"children":["Delete an existing relation"]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#createreaddelete-insights-model-builds"},"children":["Create/Read/Delete Insights Model Builds"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#get-a-list-of-insights-model-builds"},"children":["Get a list of insights model builds"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#get-the-insights-models-build-status"},"children":["Get the insights model’s build status"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#trigger-the-build-of-an-insights-model"},"children":["Trigger the build of an insights model"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#stop-the-build-of-an-insights-model"},"children":["Stop the build of an insights model"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"createreaddelete-insights-models","__idx":1},"children":["Create/Read/Delete Insights Models"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"get-a-list-of-the-accounts-insights-models","__idx":2},"children":["Get a list of the account’s insights models"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"GET /reporting/datamodels\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"get-the-build-and-query-resource-limit-sizes","__idx":3},"children":["Get the build and query resource limit sizes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"GET /reporting/account\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"sample-response","__idx":4},"children":["Sample Response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["View the query and dashboard limits in GB paying specific attention to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["build_size"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["query_size"]}," parameters."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n        \"id\": \"10\",\n        \"sisense_group_id\": \"5f7e73a8390cef002c916538\",\n        \"td_account_id\": \"6233\",\n        \"max_data_modelers\": 5,\n        \"max_designers\": 10,\n        \"max_viewers\": 20,\n        \"storage_size\": 20,\n        \"storage_threshold\": 500,\n        \"build_threshold\": 100,\n        \"query_threshold\": 100,\n        \"sisense_datagroup_oid\": \"7e550d2c-68c0-4fb1-90b0-ac40c044b096\",\n        \"sisense_hostname\": \"us01-01-development.reporting.treasuredata.com\",\n        \"build_size\": 23.0,\n        \"query_size\": 23.0,\n        \"calculated_build_size\": 23.0,\n        \"calculated_query_size\": 23.0,\n        \"current_data_modelers\": 4,\n        \"current_designers\": 2,\n        \"current_viewers\": 4\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"retrieve-a-specific-insights-model-configuration","__idx":5},"children":["Retrieve a specific insights model configuration"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"GET /reporting/datamodels/{datamodel_id}\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"create-a-new-insights-model","__idx":6},"children":["Create a new insights model"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"POST /reporting/datamodels\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"delete-an-existing-insights-model","__idx":7},"children":["Delete an existing insights model"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"DELETE /reporting/datamodels/{datamodel_id}\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"update-insights-model-share","__idx":8},"children":["Update Insights Model Share"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"share-the-insights-model-with-users","__idx":9},"children":["Share the insights model with users"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"PUT /reporting/datamodels/{datamodel_id}/shares\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"createreaddelete-datasets","__idx":10},"children":["Create/Read/Delete Datasets"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"get-a-list-of-the-datasets-in-the-insights-model","__idx":11},"children":["Get a list of the datasets in the insights model"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"GET /reporting/datamodels/{datamodel_id}/datasets\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"create-a-new-insights-model-dataset","__idx":12},"children":["Create a new insights model dataset"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"POST /reporting/datamodels/{datamodel_id}/datasets\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"delete-an-insights-model-dataset","__idx":13},"children":["Delete an insights model dataset"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"DELETE /reporting/datamodels/{datamodel_id}/datasets/{dataset_id}\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"createreadupdatedelete-tables","__idx":14},"children":["Create/Read/Update/Delete Tables"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"get-a-list-of-tables-in-a-dataset","__idx":15},"children":["Get a list of tables in a dataset"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"GET /reporting/datamodels/{datamodel_id}/datasets/{dataset_id}/tables\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"create-a-new-table-in-a-dataset","__idx":16},"children":["Create a new table in a dataset"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"POST /reporting/datamodels/{datamodel_id}/datasets/{dataset_id}/tables\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"update-an-existing-table-in-a-dataset","__idx":17},"children":["Update an existing table in a dataset"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"PUT|PATCH /reporting/datamodels/{datamodel_id}/datasets/{dataset_id}/tables/{table_id}\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"delete-an-existing-table-in-a-dataset","__idx":18},"children":["Delete an existing table in a dataset"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"DELETE /reporting/datamodels/{datamodel_id}/datasets/{dataset_id}/tables/{table_id}\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"createreaddelete-relations","__idx":19},"children":["Create/Read/Delete Relations"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"get-a-list-of-insights-model-relations","__idx":20},"children":["Get a list of insights model relations"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"GET /reporting/datamodels/{datamodel_id}/relations\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"create-a-new-relation-for-an-insights-model","__idx":21},"children":["Create a new relation for an insights model"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"POST /reporting/datamodels/{datamodel_id}/relations\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"delete-an-existing-relation","__idx":22},"children":["Delete an existing relation"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"DELETE /reporting/datamodels/{datamodel_id}/relations/{relation_id}\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"createreaddelete-insights-model-builds","__idx":23},"children":["Create/Read/Delete Insights Model Builds"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"get-a-list-of-insights-model-builds","__idx":24},"children":["Get a list of insights model builds"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"GET /reporting/datamodels/{datamodel_id}/builds\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"get-the-insights-models-build-status","__idx":25},"children":["Get the insights model’s build status"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"GET /reporting/datamodels/{datamodel_id}/builds/{build_id}\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"trigger-the-build-of-an-insights-model","__idx":26},"children":["Trigger the build of an insights model"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"POST /reporting/datamodels/{datamodel_id}/builds\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"stop-the-build-of-an-insights-model","__idx":27},"children":["Stop the build of an insights model"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"DELETE /reporting/datamodels/{datamodel_id}/builds/{build_id}\n","lang":"text"},"children":[]}]},"headings":[{"value":"Reference Insights Model Endpoints","id":"reference-insights-model-endpoints","depth":1},{"value":"Create/Read/Delete Insights Models","id":"createreaddelete-insights-models","depth":1},{"value":"Get a list of the account’s insights models","id":"get-a-list-of-the-accounts-insights-models","depth":2},{"value":"Get the build and query resource limit sizes","id":"get-the-build-and-query-resource-limit-sizes","depth":2},{"value":"Sample Response","id":"sample-response","depth":3},{"value":"Retrieve a specific insights model configuration","id":"retrieve-a-specific-insights-model-configuration","depth":2},{"value":"Create a new insights model","id":"create-a-new-insights-model","depth":2},{"value":"Delete an existing insights model","id":"delete-an-existing-insights-model","depth":2},{"value":"Update Insights Model Share","id":"update-insights-model-share","depth":1},{"value":"Share the insights model with users","id":"share-the-insights-model-with-users","depth":2},{"value":"Create/Read/Delete Datasets","id":"createreaddelete-datasets","depth":1},{"value":"Get a list of the datasets in the insights model","id":"get-a-list-of-the-datasets-in-the-insights-model","depth":2},{"value":"Create a new insights model dataset","id":"create-a-new-insights-model-dataset","depth":2},{"value":"Delete an insights model dataset","id":"delete-an-insights-model-dataset","depth":2},{"value":"Create/Read/Update/Delete Tables","id":"createreadupdatedelete-tables","depth":1},{"value":"Get a list of tables in a dataset","id":"get-a-list-of-tables-in-a-dataset","depth":2},{"value":"Create a new table in a dataset","id":"create-a-new-table-in-a-dataset","depth":2},{"value":"Update an existing table in a dataset","id":"update-an-existing-table-in-a-dataset","depth":2},{"value":"Delete an existing table in a dataset","id":"delete-an-existing-table-in-a-dataset","depth":2},{"value":"Create/Read/Delete Relations","id":"createreaddelete-relations","depth":1},{"value":"Get a list of insights model relations","id":"get-a-list-of-insights-model-relations","depth":2},{"value":"Create a new relation for an insights model","id":"create-a-new-relation-for-an-insights-model","depth":2},{"value":"Delete an existing relation","id":"delete-an-existing-relation","depth":2},{"value":"Create/Read/Delete Insights Model Builds","id":"createreaddelete-insights-model-builds","depth":1},{"value":"Get a list of insights model builds","id":"get-a-list-of-insights-model-builds","depth":2},{"value":"Get the insights model’s build status","id":"get-the-insights-models-build-status","depth":2},{"value":"Trigger the build of an insights model","id":"trigger-the-build-of-an-insights-model","depth":2},{"value":"Stop the build of an insights model","id":"stop-the-build-of-an-insights-model","depth":2}],"frontmatter":{"seo":{"title":"Reference Insights Model Endpoints"}},"lastModified":"2025-11-22T02:43:27.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/customer-data-platform/treasure-insights/reference-insights-model-endpoints","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}