thoughtspot · ShashiSubramanya · Sep 8, 2026 · Aug 5, 2026 · Aug 5, 2026 · Aug 6, 2026
diff --git a/modules/ROOT/pages/.write-test b/modules/ROOT/pages/.write-test
@@ -0,0 +1 @@
+write access test - delete me
diff --git a/modules/ROOT/pages/about-rest-apis.adoc b/modules/ROOT/pages/about-rest-apis.adoc
@@ -3,28 +3,56 @@
 
 :page-title: ThoughtSpot REST APIs
 :page-pageid: rest-apis
-:page-description: ThoughtSpot REST API provides service endpoints for administration, embedding, and data management.
+:page-description: ThoughtSpot REST APIs let you programmatically manage users, groups, and metadata objects, query data, and automate deployments. The REST API v2.0 framework is the current standard for all integrations.
 
-The ThoughtSpot REST API framework lets you create, access, edit, and manage objects and resources in the ThoughtSpot system programmatically.
+The ThoughtSpot REST API framework lets you create, access, and manage ThoughtSpot resources programmatically.
 
-ThoughtSpot REST API supports several resource collections and operations in two distinct versions:
+== Overview
+You can use REST APIs to integrate ThoughtSpot capabilities into your applications and automate workflows, without going through the ThoughtSpot UI. ThoughtSpot REST API endpoints allow you to:
 
-* REST API v1
-+
-The legacy framework with several endpoints to create, edit, administer and manage ThoughtSpot objects and data.
+* *Manage users, groups, and roles*. Create and manage user accounts, define groups and privileges, and automate provisioning workflows.
+* *Authenticate and manage sessions*. Get authentication tokens for users, including tokens for embedded application users with trusted authentication.
+* *Manage metadata objects*. Search, create, update, and delete objects such as Liveboards, Answers, Models, Worksheets, and Tables. Import and export objects as ThoughtSpot Modeling Language (TML) representations.
+* *Query data*. Run search queries against your data and fetch Liveboard, Answer, and visualization data in your application.
+* *Export reports*. Download Liveboards and Answers in PDF, PNG, CSV, or XLSX formats.
+* *Automate deployments*. Move content between environments and Orgs with TML and version control APIs, and manage multi-tenant deployments.
+* *Administer your instance*. Configure Orgs, manage connections, set up custom actions, audit activity with system logs, and manage instance settings.
+* *Work with AI and Spotter*. Create Spotter conversations, send messages, manage Spotter memory, and share conversations programmatically.
+
+== When to use REST APIs
+
+Use REST APIs when you need to:
+
+* Automate administration tasks such as user provisioning, group management, or scheduled content deployment.
+* Fetch data from ThoughtSpot into your own application or service, without embedding ThoughtSpot UI components.
+* Build deployment pipelines that promote content across development, staging, and production environments.
+* Integrate ThoughtSpot operations into external systems, such as CI/CD tooling, orchestration services, or custom portals.
 
-* REST API v2.0
+If you want to embed interactive ThoughtSpot components such as Liveboards, Search, or Spotter in your application, use the xref:getting-started.adoc[Visual Embed SDK]. The Visual Embed SDK and REST APIs are complementary; embedded applications commonly use REST APIs alongside the SDK for tasks such as token issuance for trusted authentication and metadata automation.
+
+== REST API versions
+ThoughtSpot REST APIs are available in the following versions:
+
+* REST API v2.0 (Recommended) +
+The REST API v2 framework includes a wider set of xref:rest-api-v2-reference.adoc[API endpoints] with enhanced functionality and provides an interactive Playground for ease of use.
+
+* REST API v1 (Deprecated) +
+The xref:rest-api-reference.adoc[legacy REST v1 endpoints] to create, edit, administer and manage ThoughtSpot objects and data.
 +
-The REST API v2.0 framework provides enhanced functionality and improved API experience with an interactive Playground.
+include::{path}/rest-apiv1-deprecation-note.adoc[]
 
 For more information about the differences between these two REST API versions, see xref:rest-api-v1v2-comparison.adoc[REST API v1 and v2.0 comparison].
 
 == REST API Playground
+ThoughtSpot provides an interactive playground to explore and try out API workflows on your own instance or ThoughtSpot trial instance.
+
+To view the Playground, go to *Develop* > *REST API* > *REST Playground v2.0* in your ThoughtSpot instance, or use the link:https://try-everywhere.thoughtspot.cloud/v2/#/everywhere/api/rest/playgroundV2_0[ThoughtSpot public instance, window=_blank].
 
-ThoughtSpot users with Developer or Administrator privileges can access the REST API v1 and v2.0 endpoints in the *Develop* tab. The portal provides a separate Playground for each REST API version and lets you explore the API endpoints, request and response workflows.
+In the Playground, you can:
 
-* To try out the xref:rest-api-v1.adoc[REST API v1 endpoints], click **REST Playground v1**. +
-* To access the xref:rest-api-v2.adoc[REST API v2 Playground], click **REST Playground v2.0**.
+* Browse endpoints by resource category and view request and response schemas.
+* Try API requests against your instance and inspect live responses.
+* View and copy generated code samples for your requests.
 
 == Rate limits for API requests
 To ensure API stability, optimize resource usage, and maintain service quality for all users, ThoughtSpot limits the number of public API requests allowed per client to prevent excessive requests from reaching application servers.
@@ -37,11 +65,13 @@ These rate limits are enforced by default on all ThoughtSpot instances. Currentl
 
 To update rate limits or adjust the rate limit settings for your dev or prod environment, contact ThoughtSpot Support.
 
-//ThoughtSpot administrators can monitor logs, add or update rate limits via TSCLI, and adjust these settings for different environments (dev or prod) as required.
+== REST API SDKs
 
-==  API endpoints
-For a complete list of API endpoints and information about how to make an API call to these endpoints, see the following reference pages:
+To integrate v2.0 APIs into your applications faster, ThoughtSpot provides SDK libraries in several languages, including TypeScript and Python. The SDKs wrap endpoint calls, authentication, and typed request and response models. For more information, see xref:rest-api-sdk-libraries.adoc[REST API SDK libraries].
 
-* xref:rest-api-reference.adoc[REST API v1 Reference]
-* xref:rest-api-v2-reference.adoc[REST API v2.0 Reference]
+== Related information
 
+* xref:rest-api-v2-getstarted.adoc[Get started with REST API v2.0]
+* xref:rest-api-v2-reference.adoc[REST API v2.0 reference]
+* xref:rest-apiv2-changelog.adoc[REST API v2.0 changelog]
+* xref:rest-api-sdk-libraries.adoc[REST API SDK libraries]
diff --git a/modules/ROOT/pages/admin-api.adoc b/modules/ROOT/pages/admin-api.adoc
@@ -1,14 +1,16 @@
-= Admin APIs
+= REST API v1 - Admin API endpoints
 :toc: true
 :toclevels: 1
 
 :page-title: Admin APIs
-:page-pageid: admin-api
+:page-pageid: admin-api-v1
 :page-description: The admin API endpoints allow you to view, edit, and manage your cluster configuration
 
-The admin API service allows you to query and update configuration information for a ThoughtSpot cluster. You can also use these APIs to migrate data from one cluster to another.
+include::{path}/rest-apiv1-deprecation-note.adoc[]
+
 
 == Supported operations
+The admin API service allows you to query and update configuration information for a ThoughtSpot cluster. You can also use these APIs to migrate data from one cluster to another.
 
 include::{path}/admin-api-list.adoc[]
 

diff --git a/modules/ROOT/pages/api-auth-session.adoc b/modules/ROOT/pages/api-auth-session.adoc
@@ -6,6 +6,8 @@
 :page-pageid: api-auth-session
 :page-description: To access ThoughtSpot objects and resource endpoints, authenticate and log in to the ThoughtSpot system
 
+include::{path}/rest-apiv1-deprecation-note.adoc[]
+
 To create, access, and modify ThoughtSpot objects and resources through the REST API, you must log in as an authorized user. A successful login operation returns session cookies from the ThoughtSpot system, which must be included in subsequent REST API calls.
 
 When using the REST API through a web browser, ThoughtSpot recommends that you use the xref:configure-saml.adoc[SAML SSO] or xref:trusted-authentication.adoc[trusted authentication] service to authenticate to ThoughtSpot. A successful login using the Visual Embed SDK via either of those two methods will establish the session within the web browser.