docs for 26.10.0.cl release

modules/ROOT/pages/api-changelog.adoc

@@ -8,6 +8,125 @@
 
 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.53.0, October 2026
+
+[width="100%", cols="1,4"]
+|====
+|[tag greenBackground]#NEW#
+a|
+[discrete]
+===== Spotter Analyst embed (`spotterAnalystConfig`)
+
+You can now embed a single, pinned Spotter Analyst using `spotterAnalystConfig.analystId` in `SpotterEmbed`. Setting this property locks the embed to one governed Analyst and prevents users from navigating to other Analysts or to the default Spotter.
+
+New and updated configuration properties:
+
+`SpotterAnalystConfig.analystId` (string)::
+Pins the embed to the Analyst with this GUID. Available from cluster version 26.10.0.cl.
+
+`spotterChatPinConfig` (on `SpotterSidebarViewConfig`)::
+Enables pinning and unpinning of conversations in the sidebar. Contains `enabled` (boolean, default `false`), `pinLabel` (string), and `unpinLabel` (string). Available from cluster version 26.10.0.cl.
+
+`isScopedLiveboardFilteringEnabled` (on `LiveboardViewConfig` and `AppViewConfig`)::
+Enables group-level filter and parameter scoping on Liveboards, in addition to existing Liveboard-level and tab-level scoping. Available from cluster version 26.10.0.cl.
+
+`starterPrompts` (on `SpotterChatViewConfig`)::
+Configures which starter prompt pills are shown above the Spotter chat input. Contains keys: `enable`, `quick`, `research`, `previewData`, and `liveboard`. Available from cluster version 26.10.0.cl.
+
+`openSpotterOnLiveboardByDefault` (on `SpotterChatViewConfig`)::
+Opens the Spotter chat panel automatically when a Liveboard loads. Default: `true`. Supported on `LiveboardEmbed` and `AppEmbed`. Available from cluster version 26.10.0.cl.
+
+For more information, see xref:embed-spotter-analyst.adoc[Embed Spotter Analyst].
+
+|[tag greenBackground]#NEW#
+a|
+[discrete]
+===== New `Action` enum members
+
+The following `Action` enum members are added in this release:
+
+[cols="2,3"]
+!===
+! Action ! Description
+
+! `Action.SpotterChatPin`
+! Controls the visibility and disabled state of the pin and unpin action in the Spotter conversation edit menu.
+
+! `Action.SpotterAnalystList`
+! Controls the visibility and disabled state of the Show all Analysts row in the Analyst interface.
+
+! `Action.SpotterDefaultAnalyst`
+! Controls the visibility and disabled state of the default Spotter analyst entry in the Analyst interface.
+
+! `Action.SpotterOnLiveboard`
+! Controls the Spotter button in the Liveboard header.
+
+! `Action.AllLiveboardFilters`
+! Shows, hides, or disables all filter surfaces on a Liveboard: filter chips, parameter chips, and cross-filter chips at the Liveboard, tab, and group levels. Parameter and cross-filter chips support hide only and cannot be disabled.
+
+! `Action.EditInputTable`
+! Edits an input table used by an Answer directly from the Liveboard.
+
+! `Action.QuickSearchPill`
+! Controls the Basic Search starter-prompt pill in the Spotter interface.
+
+! `Action.DeepAnalysisPill`
+! Controls the Deep Analysis starter-prompt pill in the Spotter interface.
+
+! `Action.DataLiteracyPill`
+! Controls the Data Literacy starter-prompt pill in the Spotter interface.
+!===
+
+|[tag greenBackground]#NEW#
+a|
+[discrete]
+===== New `EmbedEvent` members
+
+`EmbedEvent.SpotterConversationPinned`::
+Emitted when a user pins a Spotter conversation. Payload: `{ conversationId, pinnedAt }`. Requires `spotterChatPinConfig.enabled: true` and `enablePastConversationsSidebar: true`.
+
+`EmbedEvent.SpotterConversationUnpinned`::
+Emitted when a user unpins a Spotter conversation. Payload: `{ conversationId, unpinnedAt }`. Requires `spotterChatPinConfig.enabled: true` and `enablePastConversationsSidebar: true`.
+
+The following existing `EmbedEvent` members gained an optional `applicability` attribute for scoped filter and parameter operations:
+
+* `EmbedEvent.FilterChanged`
+* `EmbedEvent.ParameterChanged`
+
+|[tag greenBackground]#NEW#
+a|
+[discrete]
+===== New `HostEvent` members
+
+`HostEvent.PinSpotterConversation`::
+Pins a saved Spotter conversation. Accepts `{ conversationId }`. Requires `enablePastConversationsSidebar: true` on the instance.
+
+`HostEvent.UnpinSpotterConversation`::
+Unpins a previously pinned Spotter conversation. Accepts `{ conversationId }`. Requires `enablePastConversationsSidebar: true` on the instance.
+
+`HostEvent.GetGroups`::
+Returns filter and parameter group details for the current Liveboard. Response includes `orderedGroupIds`, `numberOfGroups`, and `Groups`.
+
+`HostEvent.OpenParameter`::
+Opens the parameter panel for a specific parameter on the Liveboard. Accepts an optional `applicability` object to scope the action to a tab or group.
+
+The following existing `HostEvent` members gained an optional `applicability` attribute for scoping to a Liveboard tab or group:
+
+* `HostEvent.OpenFilter`
+* `HostEvent.GetFilters`
+* `HostEvent.UpdateFilters`
+* `HostEvent.UpdateParameters`
+* `HostEvent.GetParameters`
+
+|[tag yellowBackground]#DEPRECATED#
+a|
+[discrete]
+===== `HostEvent.UpdatePersonalizedView` deprecated
+
+`HostEvent.UpdatePersonalizedView` is deprecated in this release. Use `HostEvent.SelectPersonalizedView` instead. The replacement accepts an optional `viewName` to select a view by name, resets to the original view when the payload is empty, and reports an error when the named view is not found.
+
+|====
+
 == Version 1.52.x, September 2026
 
 [width="100%" cols="1,4"]