From 47fbf2e16003f95531ebc5767add11758d72e24c Mon Sep 17 00:00:00 2001
From: Harpreet Sangar <happy_san@protonmail.com>
Date: Wed, 30 Jul 2025 19:12:50 +0530
Subject: [PATCH 1/2] Union.

---
 openapi.yml | 42 ++++++++++++++++++++++++++----------------
 1 file changed, 26 insertions(+), 16 deletions(-)

diff --git a/openapi.yml b/openapi.yml
index 93202a7..de5008f 100644
--- a/openapi.yml
+++ b/openapi.yml
@@ -2314,25 +2314,32 @@ components:
           items:
             $ref: "#/components/schemas/SearchResultHit"
         request_params:
+            $ref: "#/components/schemas/SearchRequestParams"
+        conversation:
+          $ref: "#/components/schemas/SearchResultConversation"
+        union_request_params:
+          type: array
+          description: Returned only for union query response.
+          items:
+            $ref: "#/components/schemas/SearchRequestParams"
+    SearchRequestParams:
+      type: object
+      required:
+        - collection_name
+        - q
+        - per_page
+      properties:
+        collection_name:
+          type: string
+        q:
+          type: string
+        per_page:
+          type: integer
+        voice_query:
           type: object
-          required:
-            - collection_name
-            - q
-            - per_page
           properties:
-            collection_name:
-              type: string
-            q:
+            transcribed_query:
               type: string
-            per_page:
-              type: integer
-            voice_query:
-              type: object
-              properties:
-                transcribed_query:
-                  type: string
-        conversation:
-          $ref: "#/components/schemas/SearchResultConversation"
     SearchResultConversation:
       type: object
       required:
@@ -2415,6 +2422,9 @@ components:
           type: number
           format: float
           description: Distance between the query vector and matching document's vector value
+        search_index:
+          type: integer
+          description: Returned only for union query response. Indicates the index of the query which this document matched to.
       example:
         highlights:
           company_name:

From 84a5b7a7e0b0a5fd146fb2f4b142ebb867c801bc Mon Sep 17 00:00:00 2001
From: Harpreet Sangar <happy_san@protonmail.com>
Date: Wed, 30 Jul 2025 19:30:53 +0530
Subject: [PATCH 2/2] Set `union: false` as default value.

---
 openapi.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/openapi.yml b/openapi.yml
index de5008f..85da6b6 100644
--- a/openapi.yml
+++ b/openapi.yml
@@ -3540,6 +3540,7 @@ components:
       properties:
         union:
           type: boolean
+          default: false
           description: When true, merges the search results from each search query into a single ordered set of hits.
         searches:
           type: array