api-embed-carousel

site/sigmaguides/src/Fundamentals 1: Getting Around - v3/Fundamentals 1: Getting Around v3.md

@@ -472,11 +472,13 @@ To ensure data stays under your control, Sigma also supports warehouse AI models
 
 For more information, see [Configure warehouse AI model integration](https://help.sigmacomputing.com/docs/configure-warehouse-ai-model-integration)
 
-Navigate to `Administration` > `AI settings`, select the AI provider and provide a valid `API Key`:
+Navigate to `Administration` > `AI settings`, select the AI provider and provide a valid `API Key`.
+
+Sigma supports using warehouse models in order to limit exposing your data to a third party. There is also support for external models like `OpenAI` and `Azure OpenAI`:
 
 <img src="assets/f1_43.png" width="800"/>
 
-For more information, see [Configure AI features for your organization](https://help.sigmacomputing.com/docs/configure-ai-features-for-your-organization)
+For more information, see [Configure an AI provider](https://help.sigmacomputing.com/docs/configure-ai-features-for-your-organization?_gl=1*ob89g0*_gcl_au*MTI4MzM4NjQwLjE3NTAwMzc3NzI.*_ga*MTAzMjQzMDMwNC4xNzQyMjI4NzA5*_ga_PMMQG4DCHC*czE3NTQ5MjM0MDUkbzM5NyRnMSR0MTc1NDkyMzUyNSRqMjkkbDAkaDA.#configure-an-ai-provider)
 
 ### Select data sources to make available to Ask Sigma
 Now we need to tell Sigma which data sources Ask Sigma can use. Since we are using third-party AI services like OpenAI, we want to be careful about which datasets we allow access to. This process controls that and limits access to data that may be proprietary.
@@ -515,23 +517,30 @@ Once the response is ready, you’ll see:
 - Options to adjust calculations
 - Multiple charts to choose from for your workbook
 
-Some generated charts may not be helpful—for example, `Store Latitude, Store Longitude, and Store Key` aren’t useful in this case. so we won't select them.
+Some generated charts may not be helpful—for example, so we won't select them.
 
 <img src="assets/f1_49.png" width="800"/>
 
-If you're happy with the results, you can open the selected items in a workbook—or keep refining in Ask Sigma.
+If you're happy with the results, you can open the selected items in a workbook—or keep refining in Ask Sigma:
 
+<img src="assets/f1_49a.png" width="800"/>
 
 Once inside a workbook, you can save it, make any changes you like, or use Sigma’s [Explore Anywhere](https://help.sigmacomputing.com/docs/view-underlying-data) feature for deeper analysis:
 
 <img src="assets/f1_50.png" width="500"/><br><br>
 
+We can make any adjustments we want like changing the chart title to be more clear:
+
 <img src="assets/f1_51.png" width="800"/>
 
 It’s clear that Ask Sigma changes the way people will use Sigma—and it’s only getting better. Stay tuned!
 
 ### Ask Sigma Usage Dashboard
-Sigma also provides an optional log of Ask Sigma usage. 
+Sigma also provides an optional log of Ask Sigma usage. Before Ask can capture historic data, we have to configure a storage location for the data. This is done in `Administration` > `AI Settings' > `Ask Sigma usage`:
+
+<img src="assets/f1_56.png" width="800"/>
+
+Once configured, administrators can access the usage dashboard which provides a variety of metrics and useful information.
 
 For more information, see [Configure AI features for your organization](https://help.sigmacomputing.com/docs/configure-ai-features-for-your-organization)
 

site/sigmaguides/src/embedding_rest_api_useage_11_custom_workbook_list/embedding_rest_api_useage_11_custom_workbook_list.md

@@ -0,0 +1,150 @@
+author: pballai
+id: embedding_rest_api_useage_11_custom_workbook_list
+summary: embedding_rest_api_useage_11_custom_workbook_list
+categories: embedding
+environments: web
+status: published
+feedback link: https://github.com/sigmacomputing/sigmaquickstarts/issues
+tags: default
+lastUpdated: 2025-08-12
+
+# REST API Usage 11: Custom Workbook List
+
+## Overview 
+Duration: 5
+
+This QuickStart demonstrates an interactive workbook selection experience using a simple, stable carousel interface. Users can visually browse available workbooks through thumbnail images and smooth navigation, creating an engaging way to discover and select embedded content.
+
+It’s important to understand how the workbooks displayed in the carousel are selected. Sigma is highly flexible, and workbooks can be stored in multiple locations—sometimes leading to content sprawl and the risk of exposing content to unauthorized users, whether embedded or not.
+
+For that reason, it’s best practice to store workbooks in dedicated workspaces and share those workspaces with specific users or teams. In the embed context, maintaining a 1:1 relationship between workspaces and user groups is ideal to simplify management and ensure proper access control.
+
+Our implementation uses the [List member files](https://help.sigmacomputing.com/reference/listaccessibleinodes) API endpoint, which returns **all documents and folders accessible to a specific user.**
+
+In the sample application, when a user is selected, we call this endpoint, pass the user’s `member ID`, and apply a `type filter` for workbooks only. We did not take the additional step of filtering workbooks by storage location or path.
+
+For enhanced security, you could implement path-based filtering—for example, only allowing users to access content in the `Embed_Users` workspace. You could use the user’s team membership to filter the results accordingly. This additional filtering helps prevent accidental exposure of content that users shouldn’t have access to, even if Sigma’s permission system technically permits it.
+
+The filtered response is then displayed using a carousel control, though it could just as easily be rendered with other UI components.
+
+<aside class="positive">
+<strong>IMPORTANT:</strong><br> We will rely on the information in the README for the implementation details and not discuss them in this QuickStart. A button is provided on the webpage for easy access.
+</aside>
+
+<aside class="positive">
+<strong>IMPORTANT:</strong><br> This QuickStart builds on the setup from "REST API Usage 01: Getting Started". If you haven’t yet cloned the repo, installed dependencies, and configured your Sigma workspace, please follow that QuickStart first.
+</aside>
+
+[REST API Usage 01: Getting Started](https://quickstarts.sigmacomputing.com/guide/embedding_rest_api_usage_01_getting%20started_started/index.html?index=..%2F..index#0)
+
+<aside class="positive">
+<strong>IMPORTANT:</strong><br> Some screens in Sigma may appear slightly different from those shown here. This is because Sigma continuously adds and enhances functionality. Rest assured—Sigma’s intuitive interface ensures that any differences won’t prevent you from completing the QuickStart successfully.
+</aside>
+
+For more information on Sigma's product release strategy, see [Sigma product releases](https://help.sigmacomputing.com/docs/sigma-product-releases)
+
+If something doesn’t work as expected, here's how to [contact Sigma support](https://help.sigmacomputing.com/docs/sigma-support)
+
+### Target Audience
+Developers who want to use Sigma's REST API to programmatically control Sigma in an embedded context.
+
+### Prerequisites
+
+<ul>
+  <li>Any modern browser will work.</li>
+  <li>Access to your Sigma environment.</li>
+  <li>Some familiarity with Sigma is assumed. Not all steps are shown, as the basics are assumed understood.</li>
+  <li>Microsoft VSCode or other suitable development tool.</li>
+ </ul>
+
+<aside class="positive">
+<strong>IMPORTANT:</strong><br> Sigma recommends using non-production resources when completing QuickStarts.
+</aside>
+
+<button>[Sigma Free Trial](https://www.sigmacomputing.com/free-trial/)</button><br>
+
+<button>[Download Visual Studio Code](https://code.visualstudio.com/download)</button>
+
+<aside class="negative">
+<strong>IMPORTANT:</strong><br> Some features may carry a "Beta" tag. Beta features are subject to quick, iterative changes. As a result, the latest product version may differ from the contents of this document.
+</aside>
+
+![Footer](assets/sigma_footer.png)
+
+## Start the Server
+Duration: 5
+
+Start the Express server in terminal from the `embedding_qs_series_2_api_use_cases` folder and enable debugging:
+```code
+DEBUG=true npm start
+```
+
+The server is ready when it displays: `Server listening at http://localhost:3000`.
+
+Browse to the landing page:
+```code
+http://localhost:3000
+```
+
+Select the `Custom Workbook List` page and click `Go`.
+
+![Footer](assets/sigma_footer.png)
+<!-- END OF SECTION-->
+
+## Testing
+Duration: 5
+
+Select either user and click the down arrow to open the carousel:
+
+<img src="assets/api_cwbl_01.png" width="800"/>
+
+Scroll the carousel and click any workbook to load it:
+
+<img src="assets/api_cwbl_02.png" width="800"/>
+
+<aside class="negative">
+<strong>NOTE:</strong><br> Carousel thumbnails are PNG images stored in the <code>/assets/workbook-thumbnails</code> folder with a name that matches the workbook name. Your Sigma instance may contain fewer or different workbooks, and that is expected.
+</aside>
+
+### Browser inspection
+Using the browser console log, you can observe the sequence of events after selecting the `Build` user (mode):
+
+<img src="assets/api_cwbl_03.png" width="800"/>
+
+For additional validation, you can test the `List Workbooks` endpoint in Postman:
+
+<img src="assets/api_cwbl_04.png" width="800"/>
+
+For details on using Sigma’s API with Postman, see the QuickStart: [Sigma API with Postman](https://quickstarts.sigmacomputing.com/guide/sigma_api_with_postman/index.html?index=..%2F..index#0)
+
+<aside class="positive">
+<strong>IMPORTANT:</strong><br> Click the <strong>README</strong> button to review the implementation details for this project.
+</aside>
+
+![Footer](assets/sigma_footer.png)
+<!-- END OF SECTION-->
+
+## What we've covered
+Duration: 5
+
+In this QuickStart, you learned how to create an interactive workbook selection experience using a carousel interface in an embedded Sigma application. 
+
+This design pattern provides a visually engaging and user-friendly way to browse and load embedded Sigma workbooks, while also highlighting best practices for secure content organization.
+
+**Additional Resource Links**
+
+[Blog](https://www.sigmacomputing.com/blog/)<br>
+[Community](https://community.sigmacomputing.com/)<br>
+[Help Center](https://help.sigmacomputing.com/hc/en-us)<br>
+[QuickStarts](https://quickstarts.sigmacomputing.com/)<br>
+
+Be sure to check out all the latest developments at [Sigma's First Friday Feature page!](https://quickstarts.sigmacomputing.com/firstfridayfeatures/)
+<br>
+
+[<img src="./assets/twitter.png" width="75"/>](https://twitter.com/sigmacomputing)&emsp;
+[<img src="./assets/linkedin.png" width="75"/>](https://www.linkedin.com/company/sigmacomputing)&emsp;
+[<img src="./assets/facebook.png" width="75"/>](https://www.facebook.com/sigmacomputing)
+
+![Footer](assets/sigma_footer.png)
+<!-- END OF WHAT WE COVERED -->
+<!-- END OF QUICKSTART -->