{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"redocly_category":"Products","product_name":"Treasure Insights","type":"markdown"},"seo":{"title":"Get the Status of a Build","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":"get-the-status-of-a-build","__idx":0},"children":["Get the Status of a Build"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can check the status of the build by calling API using the specific data model and build ID."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prerequisites","__idx":1},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Your ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/my-settings/getting-your-api-keys"},"children":["personal API key"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/customer-data-platform/treasure-insights/reference-insights-model-endpoints"},"children":["endpoint"]}," corresponding to your site access"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"display-the-status-of-a-specific-build","__idx":2},"children":["Display the status of a specific build"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the GET method to show the status of a specific build."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET https://${TD_API_ENDPOINT}/reporting/datamodels/ae9e7e75-9651-4d4d-afec-f7ac58b773c6/builds/5d7f0255-9e62-49ce-a4ea-36a2524d9447 \\\n-H 'authorization: TD1 xxxx/xxxxxxxxxxxxxx' \\\n-H 'accept: application/json'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"display-builds-associated-with-a-specific-data-model","__idx":3},"children":["Display builds associated with a specific data model"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can retrieve builds associated with a specific data model."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET https://${TD_API_ENDPOINT}/reporting/datamodels/xxxxxx/builds \\\n-H 'authorization: TD1 xxxx/xxxxxxxxxxxxxx' \\\n-H 'accept: application/json'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"possible-build-statuses","__idx":4},"children":["Possible build statuses"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Treasure Insights reports one of the following states when you query a build. Use them to determine whether additional action is required."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["pending — the job is queued but not yet executing."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["building — the build is currently running."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["done — the build completed successfully."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["failed — the build finished but encountered errors and needs attention."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["canceled — the build was intentionally stopped before completion."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"build-errors","__idx":5},"children":["Build Errors"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you experience a build failure, it may be because your memory usage is exceeding the allocated build size limit. To address the limit, you can reduce the data volume or reach out to your Customer Support representative."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image2022-8-17_12-45-1.addac2ed1d61ab30a8d870a681a2152ddbb70c26f5c6dfdf4411d01b2364b7ec.b979d678.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can view resource limits under Resource Entitlements in your insights models area of the dashboard."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image2022-8-17_12-37-41.864c71dace0702e24ac0ab4659c638592f5c8a1eae8ba0be0a96e7126280b525.b979d678.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"query-errors","__idx":6},"children":["Query Errors"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you are able to load the dashboard, but you experience a high resource load, you may see an error querying your data model."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image2022-8-17_12-42-26.55442dc42083281568142ff2642bb010b792a07a572f8aa6e14dd0ad45d15565.b979d678.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you experience an error querying your data model, you can try the following solutions:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Reduce widgets"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Reduce data volume"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Reach out to your Customer Support representative."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"view-the-build-and-query-resource-sizes","__idx":7},"children":["View the build and query resource sizes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Every data model, build, and dashboard/query is associated with a certain upper limit of RAM and CPU, so if the data model build exceeds that limit, users will see an error."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the GET method with the specified account id to view the query and dashboard limits in GB, paying special attention to the given response for build_size and query_size values. Similarly, users can ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/customer-data-platform/treasure-insights/viewing-an-elasticube-insights-model-limits-and-storage"},"children":["view this information in the UI"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET https://${TD_API_ENDPOINT}/reporting/xxxxxx \\\n-H 'authorization: TD1 xxxx/xxxxxxxxxxxxxx' \\\n-H 'cache-control: no-cache' \\\n-H 'accept: application/json'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"test-build-associated-with-a-specific-data-model","__idx":8},"children":["Test build associated with a specific data model"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can also test builds associated with a specific data model."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET -H 'Authorization: TD1 xxxx' \\\nhttp://${TD_API_ENDPOINT}/reporting/datamodels/b61d7523-3655-4b8c-bc69-48f7f68a5314/builds/17e374e4-8267-4fbb-be92-d87aa5823c32\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\"oid\":\"17e374e4-8267-4fbb-be92-d87aa5823c32\",\"buildType\":\"full\",\"status\":\"done\",\"created\":\"2022-06-30T08:36:21.749+00:00\",\"started\":\"2022-06-30T08:36:21.754+00:00\",\"completed\":\"2022-06-30T08:37:01.224+00:00\"}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET -H 'Authorization: TD1 xxxx' \\\nhttp://<api endpoint>/reporting/datamodels/b61d7523-3655-4b8c-bc69-48f7f68a5314/builds\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"[{\"oid\":\"17e374e4-8267-4fbb-be92-d87aa5823c32\",\"buildType\":\"full\",\"status\":\"done\",\"created\":\"2022-06-30T08:36:21.749Z\",\"started\":\"2022-06-30T08:36:21.754Z\",\"completed\":\"2022-06-30T08:37:01.224Z\"},{\"oid\":\"978c2a7a-fc1f-489c-aae4-fcdc037fd46c\",\"buildType\":\"full\",\"status\":\"done\",\"created\":\"2022-07-20T02:20:01.217Z\",\"started\":\"2022-07-20T02:20:01.226Z\",\"completed\":\"2022-07-20T02:20:41.920Z\"}]\n","lang":"json"},"children":[]}]},"headings":[{"value":"Get the Status of a Build","id":"get-the-status-of-a-build","depth":1},{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"Display the status of a specific build","id":"display-the-status-of-a-specific-build","depth":2},{"value":"Display builds associated with a specific data model","id":"display-builds-associated-with-a-specific-data-model","depth":2},{"value":"Possible build statuses","id":"possible-build-statuses","depth":2},{"value":"Build Errors","id":"build-errors","depth":2},{"value":"Query Errors","id":"query-errors","depth":2},{"value":"View the build and query resource sizes","id":"view-the-build-and-query-resource-sizes","depth":2},{"value":"Test build associated with a specific data model","id":"test-build-associated-with-a-specific-data-model","depth":2}],"frontmatter":{"seo":{"title":"Get the Status of a Build"}},"lastModified":"2025-11-22T02:43:27.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/customer-data-platform/treasure-insights/get-the-status-of-a-build","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}