26-7-0-docs-publication

modules/ROOT/pages/api-changelog.adoc

@@ -1,12 +1,36 @@
-= Visual Embed changelog
+= Visual Embed SDK changelog
 :toc: true
-:toclevels: 1
+:toclevels: 2
 
-:page-title: Changelog
+:page-title: Visual Embed SDK changelog
 :page-pageid: embed-sdk-changelog
-:page-description: Changes to the SDK and APIs
+:page-description: Changelog for the Visual Embed SDK
 
-This changelog lists only the changes introduced in the Visual Embed SDK. For information about new features and enhancements available for embedded analytics, see xref:whats-new.adoc[What's New].
+This page documents the changes introduced in each release of the Visual Embed SDK. For information about the REST API v2.0 changes, see the xref:rest-apiv2-changelog.adoc[REST API v2.0 changelog].
+
+
+== Version 1.50.x, July 2026
+
+[width="100%", cols="1,4"]
+|====
+|[tag greenBackground]#NEW FEATURE# a|
+
+[discrete]
+===== SpotterViz embed customization
+The Visual Embed SDK 1.50.0 introduces the `SpotterVizConfig` interface and `SpotterVizStarterPrompt` interface to allow embed developers to customize the SpotterViz panel on embedded Liveboards and full-application embeds.
+
+A new `SpotterVizConfig` interface is available on `LiveboardViewConfig` and `AppViewConfig` for the `spotterViz` object. This object provides branding customization controls for customizing the SpotterViz panel experience.
+
+To customize app interactions, visibility of the UI elements, and style and appearance of the SpotterViz panel, the SDK also introduces CSS variables, action IDs, and embed and host event identifiers. For more information, see xref:embed-spotterViz.adoc[SpotterViz in embedded Liveboards].
+
+|[tag greenBackground]#NEW FEATURE# a|
+
+[discrete]
+===== Home page customization in full application embedding
+For full application embedding, ThoughtSpot provides a focused and streamlined home page experience. To enable this feature, use the `HomePage.Focused` option with the `homePage` attribute in the `discoveryExperience` object.
+
+For more information, see xref:full-app-customize.adoc[Customize full application embedding].
+|====
 
 == Version 1.49.x, June 2026
 
@@ -30,42 +54,36 @@ The `visualOverrides` object provides the following customization controls to mo
 * `columns` property for column visibility, text wrapping, conditional formatting, and column summary in tables.
 
 For more information, see xref:viz-overrides.adoc[Visualization overrides].
-
-//|[tag greenBackground]#NEW FEATURE# a|
-//[discrete]
-//===== New charts library
-
-//The SDK introduces the `newChartsLibrary` parameter to enable the new Muze charting library in Liveboard and full application embedding.
-
 |[tag greenBackground]#NEW FEATURE# a|
+
 [discrete]
 ===== Liveboard browser cache refresh
+For embedded Liveboards, the SDK provides `enableLiveboardDataCache` to clear browser cache and fetch new data for the visualizations on the Liveboard.
 
-The SDK introduces the following event IDs and action ID to support programmatic and user-triggered browser cache refresh for the Liveboard ChartViz containers. These APIs require `enableLiveboardDataCache` to be enabled in your embed configuration.
-
-Events::
+The SDK also provides the following events and action ID to programmatically trigger cache refresh and control the visibility of the **Refresh** button.
 
 * `EmbedEvent.RefreshLiveboardBrowserCache` +
-Emitted when a user clicks the *Refresh* button in the Liveboard header to clear the browser cache.
-
+Emitted when the Liveboard browser cache is refreshed.
 * `HostEvent.RefreshLiveboardBrowserCache` +
-Allows the host application to programmatically trigger a browser cache refresh for all  visualization containers on the embedded Liveboard.
-
-New action ID::
-
+Trigger a manual cache refresh from the host application.
 * `Action.RefreshLiveboardBrowserCache` +
-Action ID to control the visibility of the *Refresh* button that clears the browser cache and fetches new data for Liveboard ChartViz containers.
+Action ID to show or hide the cache refresh button.
+
+For more information, see xref:embed-pinboard.adoc#liveboard-data-cache[Enable Liveboard refresh].
 
 |[tag greenBackground]#NEW FEATURE# a|
 [discrete]
 ===== Spotter file upload
-The SDK introduces the following configuration parameters in `SpotterChatViewConfig` to enable and control file uploads in the embedded Spotter chat interface.
+The SDK introduces the following configuration parameters in `SpotterChatConfig` object to enable and control file uploads in the embedded Spotter chat interface.
 
 * `spotterFileUploadEnabled` +
 When set to `true`, enables the file upload feature in the Spotter chat panel.
 
 * `spotterFileUploadFileTypes` +
-Restricts the file types allowed for upload in the Spotter chat panel. Accepts a `SpotterFileUploadFileTypes` object.
+Restricts the file types allowed for upload in the Spotter chat panel.
+
+For more information, see xref:embed-spotter.adoc#fileUpload[Allowing file uploads in Spotter chats].
+
 |====
 
 
@@ -1846,4 +1864,4 @@ Users with edit permissions can view and access the *Edit* action. The *Download
 
 When a user accesses the embedded application from a web browser that has third-party cookies disabled, the Visual Embed SDK emits the `NoCookieAccess` event to notify the developer. Cookies are disabled by default in Safari. Users can enable third-party cookies in Safari’s Preferences setting page or use another web browser.
 To know how to enable this setting by default on Safari for a ThoughtSpot embedded instance, contact ThoughtSpot Support.
-|====
+|====

modules/ROOT/pages/api-user-management.adoc

@@ -16,7 +16,7 @@ While you can delete users, it is preferable to deactivate a user, which maintai
 
 When configuring xref:configure-saml.adoc[SAML SSO] in ThoughtSpot UI, you can select the *Automatically add SAML users to ThoughtSpot upon first authentication* option, which will use the values in the SAML assertion to create a user if they do not already exist on ThoughtSpot. ThoughtSpot can also add users to groups sent within the SAML assertion. To enable and configure the SAML group attributes, contact your ThoughtSpot team.
 
-By default, ThoughtSpot sends e-mail messages to a new user and enables onboarding workflows when they  log in for the first time, even when you are embedding ThoughtSpot content. To alter this behavior at a system-wide level, you need to xref:customize-email-settings.adoc[Customize the onboarding settings].
+By default, ThoughtSpot sends e-mail messages to a new user and enables onboarding workflows when they log in for the first time, even when you are embedding ThoughtSpot content. To alter this behavior at a system-wide level, you need to xref:customize-email-settings.adoc[Customize the onboarding settings].
 The user update API also allows setting onboarding experience values for an individual user. If you need to modify the default behavior beyond the available UI options, contact your ThoughtSpot team.
 
 [NOTE]
@@ -108,9 +108,9 @@ image::./images/unsuspend.png[Unsuspended state]
 
 === User migration to IAMv2
 
-ThoughtSpot is gradually migrating its user to link:https://docs.thoughtspot.com/cloud/latest/okta-iam[Identity and Access Management v2 (IAMv2), window=_blank] to provide a more secure login and authentication experience through internal authentication with Okta. The following are some of the important points to note with this upgrade:
+ThoughtSpot is gradually migrating its users to link:https://docs.thoughtspot.com/cloud/latest/okta-iam[Identity and Access Management v2 (IAMv2), window=_blank] to provide a more secure login and authentication experience through internal authentication with Okta. The following are some of the important points to note with this upgrade:
 
-* The `email` attribute is mandatory when creating a user in ThoughtSpot Okta. ThoughtSpot recommends users to provide a valid email address during the user creation.
+* The `email` attribute is mandatory when creating a user in ThoughtSpot Okta. ThoughtSpot recommends that users provide a valid email address during user creation.
 * You must set a password during user creation if you do not want to trigger an activation email.
 * The default value for `usertype` will be `OIDC_USER`.
 
@@ -127,6 +127,26 @@ To update user details:
 * +++<a href="{{navprefix}}/restV2-playground?apiResourceId=http%2Fapi-endpoints%2Fusers%2Fupdate-user">POST /api/rest/2.0/users/{user_identifier}/update</a>+++ (Rest API v2)
 * xref:user-api.adoc#update-user[PUT /tspublic/v1/user/{userid}] (Rest API v1)
 
+[NOTE]
+====
+Updating the username of an SSO user, `account_type` set to `SAML_USER` or `OIDC_USER`, requires changes in both the IdP and ThoughtSpot.
+
+If you rename an SSO user through the REST API and that user then logs in through the IdP:
+
+* If Just-in-Time (JIT) provisioning is enabled, ThoughtSpot creates a new duplicate account. The duplicate account does not inherit the original user's content, groups, or permissions.
+* If JIT provisioning is disabled, the user cannot log in.
+
+To safely update the username of an SSO user:
+
+. Update the username in your IdP.
+. Before the user logs in again, update the username in ThoughtSpot to match the new value using the REST API or Admin UI.
+
+Both updates must be complete before the user's next SSO login.
+The order of the two steps can be reversed — you may update ThoughtSpot first and the IdP second — provided the user does not log in during the interval between the two changes.
+
+For SSO users, ThoughtSpot derives email address and display name directly from the IdP. Update these attributes in your IdP only.
+ThoughtSpot automatically reflects the new values when the user next logs in through SSO.
+Do not use the REST API or the Admin UI to update the email address or display name of an SSO user.
 
 [NOTE]
 ====
@@ -191,7 +211,7 @@ To remove a user from a group, use the update group REST v2 endpoint, or the fol
 * xref:group-api.adoc#delete-user-assoc[POST /tspublic/v1/group/{groupid}/user/{userid}] +
 removes a user from a specific group
 * xref:group-api.adoc#removeMembers[POST /tspublic/v1/group/removememberships] +
-removes a list of users] from many groups at once.
+removes a list of users from many groups at once.
 
 == Access control (sharing)
 Access to objects is determined by content *shared* directly to the user or the groups they belong to. It is easier to manage and audit sharing through groups rather than object sharing at the individual user level.
@@ -215,6 +235,17 @@ ThoughtSpot also has a default group called `All`. When you create new users in
 ====
 
 == Roles
-If Role-Based Access Control (RBAC) is enabled on your instance, administrators can define Role privileges and assign these to users via Groups.
+If Role-Based Access Control (RBAC) is enabled on your instance, administrators can define role privileges and assign them to users via groups. Roles are always scoped to an Org; a role created in one Org cannot be assigned in another.
+
+=== Assign roles to groups via REST API
+When creating or updating a group using the REST API v2 endpoints, use the `role_identifiers` parameter to assign one or more roles to the group. The parameter accepts an array of role GUIDs or role names. For more information, see:
+
+* link:{{navprefix}}/restV2-playground?apiResourceId=http%2Fapi-endpoints%2Fgroups%2Fcreate-user-group[`POST /api/rest/2.0/groups/create`]: include `role_identifiers` in the request body.
+* link:{{navprefix}}/restV2-playground?apiResourceId=http%2Fapi-endpoints%2Fgroups%2Fupdate-user-group[`POST /api/rest/2.0/groups/{group_identifier}/update`]: include `role_identifiers` to add roles to an existing group.
+
+[NOTE]
+====
+Roles must be available before they can be assigned. Use the xref:roles-api.adoc[Roles API] to create roles programmatically before calling the group create or update endpoints.
+====
 
-For more information, see xref:roles.adoc[Role-based access control] and link:https://docs.thoughtspot.com/cloud/latest/rbac[ThoughtSpot Product documentation, window=_blank].
+For a complete list of available privileges and role categories, see xref:roles.adoc[Role-based access control].

modules/ROOT/pages/common/nav-embedding.adoc

@@ -14,6 +14,7 @@ Embed ThoughtSpot in a web app
 ** link:{{navprefix}}/embed-spotter-agent[Embed Spotter Agent]
 * link:{{navprefix}}/embed-liveboard[Embed Analytics]
 ** link:{{navprefix}}/embed-liveboard[Embed a Liveboard]
+** link:{{navprefix}}/spotterViz-agent[SpotterViz AI agent in Liveboards]
 ** link:{{navprefix}}/embed-a-viz[Embed a visualization]
 * link:{{navprefix}}/full-embed[Embed full application]
 ** link:{{navprefix}}/full-app-customize[Customize your embed]
@@ -41,6 +42,34 @@ Embed without SDK
 ** link:{{navprefix}}/embed-without-sdk[Embed without SDK]
 ** link:{{navprefix}}/custom-viz-rest-api[Create a custom visualization]
 
+
+[.sidebar-title]
+Authentication and data security
+
+* link:{{navprefix}}/embed-auth[Authentication]
+** link:{{navprefix}}/trusted-auth[Trusted authentication]
+*** link:{{navprefix}}/trusted-auth-secret-key[Secret key management]
+*** link:{{navprefix}}/trusted-auth-sdk[Front-end trusted authentication integration]
+*** link:{{navprefix}}/trusted-auth-token-request-service[Token request service]
+*** link:{{navprefix}}/trusted-auth-troubleshoot[Troubleshoot trusted authentication]
+** link:{{navprefix}}/saml-sso[SAML SSO authentication]
+** link:{{navprefix}}/oidc-auth[OpenID Connect authentication]
+** link:{{navprefix}}/just-in-time-provisioning[Just-in-time provisioning]
+* link:{{navprefix}}/security-settings[Security settings]
+
+* link:{{navprefix}}/embed-object-access[Authorization]
+** link:{{navprefix}}/access-control-sharing[Access control and sharing]
+** link:{{navprefix}}/privileges-and-roles[Privileges and Roles]
+** link:{{navprefix}}/data-security[Data security]
+*** link:{{navprefix}}/rls-rules[RLS Rules]
+*** link:{{navprefix}}/abac-via-rls-variables[ABAC via RLS with variables]
+*** link:{{navprefix}}/jwt-abac-migration-guide[ABAC JWT migration guide]
+**** link:{{navprefix}}/jwt-filter-parameters-rules-migration-guide[JWT ABAC with filter rules -> ABAC via RLS]
+**** link:{{navprefix}}/jwt-abac-beta-migration-guide[JWT ABAC beta implementation -> ABAC via RLS]
+*** link:{{navprefix}}/abac-user-parameters[ABAC via JWT with filter rules and parameters]
+* link:{{navprefix}}/selective-user-access[User access]
+* link:{{navprefix}}/troubleshoot-errors[Troubleshoot errors]
+
 [.sidebar-title]
 Customize and integrate
 
@@ -89,32 +118,6 @@ Customize and integrate
 ** link:{{navprefix}}/prefetch[Prefetch static resources]
 * link:{{navprefix}}/troubleshoot-errors[Troubleshoot errors]
 
-[.sidebar-title]
-Authentication and data security
-
-* link:{{navprefix}}/embed-auth[Authentication]
-** link:{{navprefix}}/trusted-auth[Trusted authentication]
-*** link:{{navprefix}}/trusted-auth-secret-key[Secret key management]
-*** link:{{navprefix}}/trusted-auth-sdk[Front-end trusted authentication integration]
-*** link:{{navprefix}}/trusted-auth-token-request-service[Token request service]
-*** link:{{navprefix}}/trusted-auth-troubleshoot[Troubleshoot trusted authentication]
-** link:{{navprefix}}/saml-sso[SAML SSO authentication]
-** link:{{navprefix}}/oidc-auth[OpenID Connect authentication]
-** link:{{navprefix}}/just-in-time-provisioning[Just-in-time provisioning]
-* link:{{navprefix}}/security-settings[Security settings]
-
-* link:{{navprefix}}/embed-object-access[Authorization]
-** link:{{navprefix}}/access-control-sharing[Access control and sharing]
-** link:{{navprefix}}/privileges-and-roles[Privileges and Roles]
-** link:{{navprefix}}/data-security[Data security]
-*** link:{{navprefix}}/rls-rules[RLS Rules]
-*** link:{{navprefix}}/abac-via-rls-variables[ABAC via RLS with variables]
-*** link:{{navprefix}}/jwt-abac-migration-guide[ABAC JWT migration guide]
-**** link:{{navprefix}}/jwt-filter-parameters-rules-migration-guide[JWT ABAC with filter rules -> ABAC via RLS]
-**** link:{{navprefix}}/jwt-abac-beta-migration-guide[JWT ABAC beta implementation -> ABAC via RLS]
-*** link:{{navprefix}}/abac-user-parameters[ABAC via JWT with filter rules and parameters]
-* link:{{navprefix}}/selective-user-access[User access]
-* link:{{navprefix}}/troubleshoot-errors[Troubleshoot errors]
 
 [.sidebar-title]
 Embedding tutorials
@@ -170,10 +173,6 @@ include::generated/typedoc/CustomSideNav.adoc[]
 [.sidebar-title]
 Additional resources
 
-* link:{{navprefix}}/embed-ts[About ThoughtSpot embedding]
-* link:{{navprefix}}/get-started-tse[Embed licenses]
-* link:{{navprefix}}/license-feature-matrix[Feature matrix]
 * link:{{navprefix}}/faqs[FAQs]
-* link:{{navprefix}}/code-samples[Code samples]
 * link:https://codesandbox.io/s/big-tse-react-demo-i4g9xi[React CodeSandbox, window=_blank]
-* link:https://codesandbox.io/s/graphqlcookieembed-wf4fk9?file=/src/App.js:418-426[GraphQL CodeSandbox, window=_blank]
+* link:https://github.com/thoughtspot/developer-examples[Developer examples, window=_blank]