From d696b1fe6a5da3310f8392b46f3e6a925fade3f5 Mon Sep 17 00:00:00 2001 From: Bryant Howell - ThoughtSpot <83678239+bryanthowell-ts@users.noreply.github.com> Date: Mon, 12 Jan 2026 16:05:35 -0600 Subject: [PATCH 1/2] Update intro-thoughtspot-objects.adoc Added section on GUIDs and obj_id --- modules/ROOT/pages/intro-thoughtspot-objects.adoc | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/modules/ROOT/pages/intro-thoughtspot-objects.adoc b/modules/ROOT/pages/intro-thoughtspot-objects.adoc index 4aee463e6..da3db0790 100644 --- a/modules/ROOT/pages/intro-thoughtspot-objects.adoc +++ b/modules/ROOT/pages/intro-thoughtspot-objects.adoc @@ -12,10 +12,19 @@ Before you look at the rest of the developer documentation, please review this p == Object model hierarchy -The following figure illustrates the object model hierarchy in ThoughtSpot. +The following figure illustrates the object model hierarchy in ThoughtSpot within a single xref:orgs.adoc[Org]: image::./images/object_model_hierarchy.png[Object Model Hierarchy] +== Object identifiers +Every object on a ThoughtSpot has a globally unique ID (GUID), visible in URLs and in REST API responses as the `id` or `metadata_id` property. GUIDs are unique within a ThoughtSpot instance and thus cannot repeat in different Orgs. + +Objects have an additional `obj_id` property that is *user-settable* and *unique per Org*. It appears as `metadata_obj_id` in responses from the `/metadata/search` REST API. + +Each Org can have one object with a particular `obj_id`. The combination of `org_id` + `obj_id` is completely unique per instance, so it is equivalent to the object's GUID. + +`obj_id` allows exporting TML that can be imported into any Org on any instance, letting ThoughtSpot determine the GUIDs of the object automatically without requiring any additional effort on your part. + == Data modeling You must create a data model comprising at least one link:https://docs.thoughtspot.com/cloud/latest/connections[connection, window=_blank] with one link:https://docs.thoughtspot.com/cloud/latest/connect-data[Table, window=_blank] to begin using link:https://docs.thoughtspot.com/cloud/latest/search-data[Search data, window=_blank] to create content. Most often, there will be multiple *Tables*, with a variety of link:https://docs.thoughtspot.com/cloud/latest/tables-join[joins, window=_blank] defined in ThoughtSpot, with a link:https://docs.thoughtspot.com/cloud/latest/models[Model, window=_blank] bringing those tables together into a presentable analytic data model for the end-users. From f0d8f0036fed0269ee4e005b339ba6b10892df19 Mon Sep 17 00:00:00 2001 From: "bryant.howell" Date: Wed, 4 Feb 2026 15:33:59 -0600 Subject: [PATCH 2/2] Added obj_id to property list --- modules/ROOT/pages/intro-thoughtspot-objects.adoc | 2 ++ 1 file changed, 2 insertions(+) diff --git a/modules/ROOT/pages/intro-thoughtspot-objects.adoc b/modules/ROOT/pages/intro-thoughtspot-objects.adoc index da3db0790..372452d42 100644 --- a/modules/ROOT/pages/intro-thoughtspot-objects.adoc +++ b/modules/ROOT/pages/intro-thoughtspot-objects.adoc @@ -98,6 +98,8 @@ The object representations in ThoughtSpot REST API include the following propert * `id` + GUID of the object. Unique within a given ThoughtSpot instance +* `obj_id` + +User-defined string identifer of the object. Unique within a given Org * `author` + GUID of the user who created / uploaded the object, or had the object transferred to them. * `owner` +