Deprecation announcements

Deprecation announcements

As ThoughtSpot applications evolve, some existing features will be deprecated and replaced with new and improved functionality. A deprecated feature may continue to be functional for a short period, but will not be maintained or supported with new workflows and functionality in subsequent releases.

Deprecated features🔗

FeatureImpacted interface and release versionsDeprecation dateEnd of Support / removal from the product

REST API v1 Playground

ThoughtSpot Cloud 10.14.0.cl and later

November 2025

November 2025

Sage Search and Ask Sage

  • ThoughtSpot Cloud 10.13.0.cl and later

  • Visual Embed SDK version 1.40.0 and later

September 2025

September 2025

Delete and update connection API v2 endpoints

REST API v2

  • ThoughtSpot Cloud 10.4.0.cl and later

November 2024

September 2025

IAMv1

  • ThoughtSpot Cloud 10.8.0.cl and later

November 2024

June 2025 (tentative)

Search Assist

  • Application UI and Visual Embed Playground

    • ThoughtSpot Cloud 10.1.0.cl and later

    • ThoughtSpot Software 10.1.0.sw and later

  • Visual Embed SDK version 1.35.0 and later

September 2024

November 2024

Classic experience for Liveboards, Answers, and SpotIQ

Application UI

  • ThoughtSpot Cloud 10.1.0.cl and later

  • ThoughtSpot Software 10.1.0.sw and later

February 2024

August 2024

Page title customization

Application UI

  • ThoughtSpot Cloud 10.1.0.cl and later

  • ThoughtSpot Software 10.1.0.sw and later

February 2024

August 2024

Application Background style customization

Application UI

  • ThoughtSpot Cloud 10.3.0.cl and later

  • ThoughtSpot Software 10.7.0.sw and later

July 2024

September 2024

customCssUrl parameter

ThoughtSpot Embedded interfaces

  • Visual Embed SDK version 1.30.0 and later

  • ThoughtSpot Cloud 10.0.0.cl and later

  • ThoughtSpot Software 9.5.1.sw and later

June 2024

July 2024

jwt_user_options parameter

REST API v2.0 authentication token endpoints

  • ThoughtSpot Cloud 9.12.0.cl and later

  • ThoughtSpot Software 10.1.0.sw and later

May 2024

June 2024

default_branch_name and guid_mapping_branch_name parameters

REST API v2 version control APIs

  • ThoughtSpot Cloud 9.10.5.cl and later

  • ThoughtSpot Software 10.1.0.sw and later

March 2024

April 2024

REST API v2 Beta endpoints

REST API

  • ThoughtSpot Cloud 9.0.0.cl and later

  • ThoughtSpot Software 9.0.1.sw and later

September 2022

January 2023

REST API v1 Playground deprecation🔗

The REST API v1 Playground experience that is currently available from the Develop page of the ThoughtSpot UI will be removed from the UI in the 10.14.0.cl release version.

Impact on your instance

Only the REST API v1 Playground will be removed from the ThoughtSpot UI. However, the REST API v1 endpoints will still be available for API calls from client applications and will continue to function as usual.

Recommended action

When the REST API v1 Playground is no longer available in the ThoughtSpot UI, use the REST API v1 Reference Guide for information about the REST API v1 endpoints, request and response flows. Additionally, ThoughtSpot recommends that you gradually migrate your application workflows to REST API v2 endpoints. The REST API v2 framework is regularly updated with new enhancements and bug fixes, and also offers a more standardized API experience.

Sage and Ask Sage deprecation🔗

The Sage Search (the legacy Natural Language Search interface) and Ask Sage features will be deprecated in version 10.13.0.cl, which is scheduled for release in September 2025. Along with this, the SageEmbed library in the Visual Embed SDK will also be deprecated.

Impact on your instance

This change will impact all ThoughtSpot instances and applications that use the Natural Language Search (legacy) interface embedded using the SageEmbed library in Visual Embed SDK.

Recommended action

Customers using the legacy Natural Language Search interface and Ask Sage in their embedding applications are advised to upgrade to Spotter. We recommend that you start using Spotter by the 10.11.0.cl release (July 2025), so that you have sufficient time to test your rollout.
Spotter provides advanced natural language search capabilities and a conversational interface to allow users to interact with the AI analyst and ask follow-up questions. To know more about Spotter and learn how to embed Spotter in your embedding application, refer to the following documentation:

Delete and update connection API v2 endpoints🔗

The following Connection API v2 endpoints are deprecated and will be removed from the product in September 2025:

Effective from
ThoughtSpot Cloud 10.4.0.cl

Recommended action🔗

Use the following API endpoints to update and delete connection objects:

Note that the connection_identifier in both these endpoints is a path parameter and must be included in the request URLs for update and delete operations.

IAMv1🔗

Identity and Access Management (IAMv1) will be deprecated for all ThoughtSpot embedded customers tentatively in 10.8.0.cl. IAMv2 will be enabled on ThoughtSpot instances during maintenance windows from 10.4.0.cl onwards.

Effective from

  • ThoughtSpot Cloud 10.8.0.cl

Recommended action🔗

Search assist🔗

The Search Assist feature in Data workspace > Worksheets is deprecated. Due to this, the Enable Search Assist checkbox in the Visual Embed Playground and enableSearchAssist property in the SDK may not show the intended result.

Effective from

  • ThoughtSpot Cloud 10.1.0.cl

  • ThoughtSpot Software 10.1.0.sw

Recommended action

The Search Assist feature for Worksheets and the Enable Search Assist checkbox in Search Embed Playground will be removed from ThoughtSpot application in 10.4.0.cl. If your embedding application uses the enableSearchAssist property, you may want to update your deployment.

Classic experience for Liveboards, Answers, and SpotIQ🔗

Starting from 10.1.0.cl, classic experience for Liveboards, Answers, and SpotIQ will no longer be available. On ThoughtSpot embedded instances, developers will no longer be able to switch to the Liveboard classic experience using the liveboardV2 parameter in the Visual Embed SDK.

Effective from

  • ThoughtSpot Cloud 10.1.0.cl

  • ThoughtSpot Software 10.1.0.sw

Recommended action🔗

If you are using Liveboards in the classic experience mode, note that the new experience will become the only available option when your instance is upgraded to 10.1.0.cl. On ThoughtSpot embedded instances, the "liveboardv2":"false" setting in the SDK becomes invalid as classic experience will no longer be available.

Page title customization🔗

The Page title customization option on the Admin > Style customization and Develop > Customizations > Styles page is deprecated and removed from the UI. The Page title customization setting allowed administrators and developers to customize the title of the browser tab for ThoughtSpot application pages. This setting is deprecated to allow administrators to use the Product name parameter in the Admin > Onboarding page as a single setting to customize product name for all purposes.

Effective from

  • ThoughtSpot Cloud 10.1.0.cl

  • ThoughtSpot Software 10.1.0.sw

Recommended action🔗

If you have customized the Page title setting, after your instance is upgraded to 10.1.0.cl, the browser tab loading ThoughtSpot application pages will display the title in the following format:

  • Liveboard or Answer page - <Object name> | <Product name>

  • Other application pages - <Product name>

Administrators can use the Product name parameter in the Admin > Onboarding page to customize the product name displayed in browser tab titles.

Note that this change will not impact full application embedding if your host application uses its own browser tab titles.

Application background customization via UI🔗

The application background customization option that is currently available on the Admin > Style customization and Develop > Customizations > Styles will be deprecated in the upcoming version.

Effective from

  • ThoughtSpot Cloud 10.3.0.cl

  • ThoughtSpot Software 10.7.0.sw

Recommended action🔗

To customize the background color of ThoughtSpot application, use the --ts-var-root-background CSS variable available with the CSS customization framework and Visual Embed SDK. For more information, see CSS customization framework.

Deprecation of customCssUrl parameter🔗

The customCssUrl parameter in the EmbedConfig interface in the Visual Embed SDK is deprecated and will not be supported in future release versions.

Effective from

  • Visual Embed SDK version 1.30.0

  • ThoughtSpot Cloud 10.0.0.cl

  • ThoughtSpot Software 9.5.1.sw

Recommended action🔗

If you are using the CSS variables and overrides feature to rebrand or customize embedded pages, no action is required. However, if your implementation uses the customCssUrl parameter in the EmbedConfig interface to point to a custom CSS file, ThoughtSpot recommends switching to the customCSSUrl property in the customizations interface in the init code as shown in this example:

init({
  thoughtSpotHost: "https://<ThoughtSpot-Host>",
  authType: AuthType.None,
  customizations: {
    style: {
       customCSSUrl: 'https://cdn.jsdelivr.net/cssfilename.css',
    },
  },
});

If you are embedding ThoughtSpot without the SDK, you can switch to Visual Embed SDK and use the customization framework, or contact ThoughtSpot Support to configure your embed to point to your custom CSS file.

Deprecated parameter in REST API v2.0 authentication token endpoints🔗

The jwt_user_options object property in /api/rest/2.0/auth/token/full and /api/rest/2.0/auth/token/object is deprecated.

Effective from

  • ThoughtSpot Cloud 9.12.0.cl

  • ThoughtSpot Software 10.1.0.sw

Recommended action🔗

Use the user_parameters property available with the /api/rest/2.0/auth/token/full and /api/rest/2.0/auth/token/object endpoints to define security entitlements to a user session.
For more information, see ABAC via tokenBeta.

Deprecated parameters in Version Control APIs🔗

The default_branch_name and guid_mapping_branch_name parameters available with the /api/rest/2.0/vcs/git/config/create and /api/rest/2.0/vcs/git/config/update endpoints are deprecated.

Effective from

  • ThoughtSpot Cloud 9.10.5.cl

  • ThoughtSpot Software 10.1.0.sw

Recommended action🔗

  • default_branch_name is replaced by the commit_branch_name parameter.

  • guid_mapping_branch_name is replaced by the configuration_branch_name parameter.

Use the new parameters to configure Git branches for version control. For more information, see Git integration and version control.

Deprecation of REST API v2 (Beta) endpoints🔗

The REST API v2 Beta endpoints are deprecated from 8.10.0.cl release. These API endpoints will remain functional but will not be accessible from the REST API Playground page from 9.0.0.cl onwards.

Effective from

  • ThoughtSpot Cloud 8.10.0.cl

  • ThoughtSpot Software 9.0.1.sw

Recommended action🔗

If your current deployment uses REST API v2 Beta endpoints, your implementation may continue to work. However, we recommend transitioning to the REST API v2.0 endpoints as and when ThoughtSpot rolls out the new APIs for production use cases and General Availability (GA).

REST API SDK for v2 (Beta) endpoints🔗

The REST API v2 Beta SDK is deprecated from 8.8.0.cl onwards. ThoughtSpot does not recommend using REST API SDK to call REST API v2 Beta v2.0 endpoints.

Effective from

  • ThoughtSpot Cloud 8.8.0.cl

  • ThoughtSpot Software 9.0.1.sw

Recommended action🔗

Use the new version of REST API v2.0 endpoints and SDK versions available for these endpoints. For more information, see REST API v2.0 SDKs.

Documentation🔗

Starting from 9.0.0.cl, the API documentation for the REST API v2 Beta endpoints will not be accessible from the REST API Playground in ThoughtSpot. For information about the REST API v2 Beta endpoints, see REST API v2 Beta reference.

Recommended action

For information about REST API v2.0 endpoints, refer to the following articles and visit the REST API v2 Playground.