> To build or manage a Wix site with an AI agent, follow https://www.wix.com/headless/skill.md
> It builds a new Wix site or puts your own site online, from a prompt, and keeps changing it afterwards. The pages are code in any web technology, and Wix runs the backend.
> It works through the Wix plugin (the Wix MCP and the Wix skills), the Wix CLI or no Wix login, and puts the site live on Wix hosting or on another host.
> Business features include a store, bookings, events and tickets, a restaurant, a blog, forms, members and many more.
> Read the Wix skills online at https://www.wix.com/skills
> 
> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - If a reference page seems to be missing its schema (parameters, return types, or type definitions), append `?schema=true` to its `.md` URL (e.g. `https://dev.wix.com/docs/contexts/contexts/stores/category-info/use-category-info-context.md?schema=true`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Sample Flows

## Article: Sample Flows

## Article Link: https://dev.wix.com/docs/api-reference/business-management/site-search/wix-site-search/sample-flows.md

## Article Content:

# Sample Use Cases & Flows

This article presents possible use cases and corresponding sample flows that your app can support. It provides a useful starting point as you plan your app's implementation.

## Search for jazz events in San Francisco

If you're developing a tickets app, and you want to search for jazz events in San Francisco, do the following: 

1. [Search](https://dev.wix.com/docs/api-reference/business-management/site-search/wix-site-search/search.md) the [EVENTS document type](https://dev.wix.com/docs/api-reference/business-management/site-search/wix-site-search/schemas-for-wix-search.md) for 'jazz' in the `expression` field, and filter by `location` for San Francisco.

    ```js
    {
      "search": {
        "filter": {
          "location": "san francisco"
        }
        "aggregations": [],
        "sort": [],
        "search": {
          "fields": [],
          "expression": "jazz"
        },
        "paging": {}
      },
      "documentType": "EVENTS"
    }
    ```
2. Retrieve all the jazz events in San Francisco.

## Find the lowest price for products in stock and out of stock

If you're developing a wholesale app, you can perform an aggregation on a site with store products to count how many products are in stock vs out of stock, and what is the lowest price for the in-stock products vs. the out of stock products. 

To do this, you need to perform a nested aggregation: 

1. First perform a `value` aggregation with `"fieldPath": "inStock"` to get the products that are in stock and out of stock (since this field is a boolean). 

2. Then add a `scalar` aggregation with `"fieldPath": "discountedPriceNumeric", "type": "MIN"` to get the minimum price for the in-stock and out-of-stock products returned in the first aggregation.  

    **Sample request:** 

    ```json
    {
      "search": {
        "aggregations": [
          {
            "name": "Lowest price for products in stock and out of stock.",
            "type": "NESTED",
            "nested": {
              "nestedAggregations": [
                {
                  "name": "in-stock",
                  "type": "VALUE",
                  "fieldPath": "inStock",
                  "value": {}
                },
                {
                  "name": "min-price",
                  "type": "SCALAR",
                  "fieldPath": "discountedPriceNumeric",
                  "scalar": {
                    "type": "MIN"
                  }
                }
              ]
            }
          }
        ],
      },
      "documentType": "STORES_PRODUCTS"
    }
    ```

    **Sample response:** 

    ```json
    "aggregationData": {
        "results": [
          {
            "name": "Lowest price for products in stock and out of stock.",
            "type": "NESTED",
            "nested": {
              "results": [
                {
                  "results": {
                    "in-stock": {
                      "value": {
                        "value": "true",
                        "count": 3
                      }
                    },
                    "min-price": {
                      "scalar": {
                        "value": 899
                      }
                    }
                  }
                },
                {
                  "results": {
                    "in-stock": {
                      "value": {
                        "value": "false",
                        "count": 2
                      }
                    },
                    "min-price": {
                      "scalar": {
                        "value": 500
                      }
                    }
                  }
                }
              ]
            }
          }
        ]
      },
    ```

In our example, the lowest price among the 3 in-stock products is $899, and the lowest price among the 2 out-of-stock products is $500.