deprecation updates

Author: ShashiSubramanya

modules/ROOT/pages/deprecated-features.adoc

@@ -14,7 +14,11 @@ As ThoughtSpot applications evolve, some existing features will be deprecated an
 [options='header']
 |=====
 |Feature|Impacted interface and release versions|Deprecation date |End of Support / removal from the product
-a|xref:deprecated-features.adoc#SagePrivilegeDeprecation[`PREVIEW_THOUGHTSPOT_SAGE` privilege deprecation] a|ThoughtSpot Cloud 26.3.0.cl and later | March 2026 | September 2026
+a|xref:deprecated-features.adoc#v1-v2-exp-fullApp-embed[V1 and V2 UI experience in full application embedding]|ThoughtSpot Cloud 26.8.0.cl and later | February 2026 | August 2026
+a|xref:deprecated-features.adoc#PNGFlowDeprecation[Select PNG export options] a|ThoughtSpot Cloud 26.4.0.cl and later | April 2026 | August 2026
+a|xref:deprecated-features.adoc#variableApis[Variable APIs] a|ThoughtSpot Cloud 26.4.0.cl and later | April 2026 | November 2026
+a|xref:deprecated-features.adoc#metadataParameterization[Metadata parameterization] a|ThoughtSpot Cloud 26.4.0.cl and later | April 2026 | November 2026
+a|xref:deprecated-features.adoc#SagePrivilegeDeprecation[PREVIEW_THOUGHTSPOT_SAGE privilege] a|ThoughtSpot Cloud 26.3.0.cl and later | March 2026 | September 2026
 a|xref:deprecated-features.adoc#_answer_data_panel_classic_experience_deprecation[Answer Data panel classic experience] |ThoughtSpot Cloud 26.4.0.cl and later | April 2026 | August 2026
 a|xref:deprecated-features.adoc#_worksheet_deprecation_and_removal[Worksheets] a| ThoughtSpot Cloud 10.4.0.cl and later
 |November 2024 | September 2025
@@ -81,6 +85,68 @@ a|xref:deprecated-features.adoc#_deprecated_parameter_in_rest_api_v2_0_authentic
 ||||
 |=====
 
+[#v1-v2-exp-fullApp-embed]
+== V1 and V2 navigation and home page experience in full app embed
+Starting with ThoughtSpot 26.8.0.cl, the V3 navigation and home page experience will be set as the default UI experience in full application embedding. The V1 and V2 navigation and home page experience will be deprecated and will no longer be supported.
+
+Impact on your instance::
+If your embed currently uses the Classic (v1) or v2 navigation and home page experience, the UI will be automatically upgraded to the V3 experience. This change applies to all deployments embedding the full ThoughtSpot application.
+
+Recommended action::
+If your embed deployments are still using the legacy experience modes, we recommend that you enable the V3 navigation and home page experience in your development environments and evaluate the changes. For information on the features available in V3 experience mode, refer to the xref:full-app-customize.adoc[Full application embedding documentation].
+
+[#PNGFlowDeprecation]
+== Deprecating select options in PNG export
+The `include_cover_page` and `include_filter_page` options for the `POST /api/rest/2.0/report/liveboard` endpoint are now deprecated for PNG downloads.
+
+The Liveboard Report API has improved PNG export options which generate high-quality PNGs that closely match the Liveboard experience. It supports `image_resolution` (up to 3840px wide), `image_scale` (zoom), and allows developers to export a specific tab instead of stitching all tabs vertically.
+
+Impact on your instance::
+* For current users, starting with the ThoughtSpot 26.8.0.cl release, API calls to the `POST /api/rest/2.0/report/liveboard` endpoint for PNG exports with `include_cover_page` and `include_filter_page` will result in an error.
+** If you are currently using the legacy PNG export flow with `include_cover_page` and `include_filter_page`, it will continue to work without interruption until the ThoughtSpot 26.8.0.cl release.
+** If you have enabled the new PNG export flow with `image_resolution`, `image_scale`, and `include_header` , API calls to the `POST /api/rest/2.0/report/liveboard` endpoint for PNG exports with legacy options will result in an error.
+* For new users, API calls to the `POST /api/rest/2.0/report/liveboard` endpoint for PNG exports with `include_cover_page` and `include_filter_page` will result in an error. Use the new PNG export options.
+//If you still have to use these options for your ThoughtSpot instance contact ThoughtSpot support to revert to these legacy settings.
+
+For more information on PNG export, see xref:data-report-v2-api.adoc#_liveboard_report_api[Liveboard Report API]
+
+Recommended action::
+* We recommend transitioning to the new flow for PNG exports, as the `include_cover_page` and `include_filter_page` attributes will be removed in a future release.
+* Contact ThoughtSpot support to enable the new settings for PNG downloads on your ThoughtSpot instance.
+* PNG download now supports exporting only one tab at a time. If the `tab_identifier` is not specified, the first tab will be downloaded.
+
+[#variableApis]
+== Variable APIs for update and delete operations
+
+The `/api/rest/2.0/template/variables/{identifier}/delete` and `/api/rest/2.0/template/variables/update-values` endpoints are deprecated in 26.4.0.cl and will be removed from ThoughtSpot in an upcoming release:
+
+Impact on your instance::
+Your existing implementation will continue to work until further notice. However, these endpoints will be removed from ThoughtSpot in a future release. Therefore, ThoughtSpot recommends using the following new API endpoints: +
+** `POST /api/rest/2.0/template/variables/{identifier}/update-values` +
+Assigns multiple values to variables and sets the scope for variable values in a single API request.
+** `POST /api/rest/2.0/template/variables/delete` +
+Deletes one or more variables in a single API request.
+
+Recommended action::
+If you are using legacy variable update and delete APIs, update your workflows to use the new API endpoints. Test the changes in your development environment before updating your production integrations.
+
++
+For more information, see link:https://developers.thoughtspot.com/docs/26.4.0.cl?pageid=variables[Variables documentation, window=_blank].
+
+[#metadataParameterization]
+== Metadata parameterization API
+
+The `/api/rest/2.0/metadata/parameterize` endpoint is deprecated in 26.4.0.cl and will be removed in a future release.
+
+Impact on your instance::
+Your existing implementation will continue to work until further notice. However, ThoughtSpot recommends using the `/api/rest/2.0/metadata/parameterize-fields` for metadata parameterization.
+
+Recommended action::
+If you are using the legacy API endpoint, update your workflows to use the new API endpoint. Test the changes in your development environment before updating your production integrations.
+
++
+For more information, see link:https://developers.thoughtspot.com/docs/26.4.0.cl?pageid=parameterize-metadata[Metadata parameterization documentation, window=_blank].
+
 [#SagePrivilegeDeprecation]
 == `PREVIEW_THOUGHTSPOT_SAGE` privilege deprecation
 The `PREVIEW_THOUGHTSPOT_SAGE` privilege is renamed to `CAN_USE_SPOTTER` with the ThoughtSpot 26.3.0.cl release version.
@@ -92,7 +158,7 @@ Impact on your instance::
 Recommended action::
 For ThoughtSpot instances which have enabled RBAC before the 26.3.0.cl release, the admins will have to create a role in accordance with the newer privilege name.
 
-
+[#_answer_data_panel_classic_experience_deprecation]
 == Answer Data panel classic experience deprecation
 The classic Data panel experience in Search and Answer pages will be deprecated in ThoughtSpot 26.4.0.cl release version. The new data panel experience, which provides a more intuitive layout with improved organization of data elements and features such as query sets and custom groups, will be the default data panel experience on all ThoughtSpot Embedded instances using Visual Embed SDK v1.41.1 or later.
 
@@ -114,7 +180,7 @@ Recommended action::
 * If your instance has Worksheets, verify whether they are replaced with Models after your instance is upgraded to 10.12.0.cl.
 * If you are importing Worksheet TML, the import operation will fail. Therefore, ThoughtSpot recommends converting Worksheets to Models and then importing Model TMLs to ThoughtSpot.
 * Update your CI/CD and Git workflows to use Model TMLs instead of Worksheets.
-* In REST APIs, the subtypes of `LOGICAL_TABLE`  objects may still be referred to as Worksheet. However, these subtypes  imply Models. When you specify subtype `WORKSHEET`, the API will include Models in the response or operation.
+* In REST APIs, the subtypes of `LOGICAL_TABLE` objects may still be referred to as Worksheet. However, these subtypes imply Models. When you specify subtype `WORKSHEET`, the API will include Models in the response or operation.
 * You may find the "Worksheet" terminology in the Visual Embed SDK configuration properties and feature flags; for example, the `worksheetId` property in Spotter embed. However, when configuring these settings, use the Model object and its associated properties.
 
 [#restApiPlayground]
@@ -131,7 +197,7 @@ When the REST API v1 Playground is no longer available in the ThoughtSpot UI, us
 [#SageDeprecationNotice]
 == Sage and Ask Sage deprecation
 
-The Sage Search (the legacy Natural Language Search interface) and *Ask Sage* features are deprecated from 10.11.0.cl and will be removed from the product in December 2025.
+The Sage Search (the legacy Natural Language Search interface) and *Ask Sage* features are deprecated starting from 10.11.0.cl and will be removed from the product in December 2025.
 Along with this, the xref:SageEmbed.adoc[SageEmbed] library in the Visual Embed SDK will also be deprecated.
 
 //with no new enhancements or bug fixes supported after July 2025.
@@ -260,15 +326,15 @@ If you are embedding ThoughtSpot without the SDK, you can switch to Visual Embed
 
 == 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.
+The `jwt_user_options` object property in `/api/rest/2.0/auth/token/full` and `/api/rest/2.0/auth/token/object` endpoints 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 xref:abac-user-parameters.adoc[ABAC via token][beta betaBackground]^Beta^.
+For more information, see xref:abac-user-parameters.adoc[ABAC via token ^Beta^].
 
 == Deprecated parameters in Version Control APIs
 
@@ -314,4 +380,4 @@ Recommended action::
 For information about REST API v2.0 endpoints, refer to the following articles and visit the link:{{navprefix}}/restV2-playground?apiResourceId=http%2Fgetting-started%2Fintroduction[REST API v2 Playground].
 
 * xref:rest-api-v2-getstarted.adoc[REST API v2.0]
-* xref:rest-api-v1v2-comparison.adoc[REST API v1 and v2.0 comparison]
+* xref:rest-api-v1v2-comparison.adoc[REST API v1 and v2.0 comparison]