add search endpoint

Author: ethanpalm

api-reference/chat/search.mdx

@@ -0,0 +1,3 @@
+---
+openapi: "POST /search/{domain}"
+---

discovery-openapi.json

@@ -21,7 +21,7 @@
         "x-mcp": {
           "enabled": true
         },
-        "summary": "Generate Assistant Message",
+        "summary": "Generate assistant message",
         "description": "Generates a response message from the assistant for the specified domain. For best results, use the [useChat hook from ai-sdk](https://ai-sdk.dev/docs/reference/ai-sdk-ui/use-chat#usechat) to send requests and handle responses. You can set `fp`, `threadId`, and `filter` in the `body` field of the options parameter passed to the hook.",
         "parameters": [
           {
@@ -498,6 +498,96 @@
           }
         }
       }
+    },
+    "/search/{domain}": {
+      "post": {
+        "x-mcp": {
+          "enabled": true
+        },
+        "summary": "Search for documentation",
+        "description": "Perform semantic and keyword searches across your documentation with configurable filtering and pagination.",
+        "parameters": [
+          {
+            "name": "domain",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "description": "The domain identifier from your `domain.mintlify.app` URL. Can be found in the top left of your dashboard."
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "required": ["query"],
+                "properties": {
+                  "query": {
+                    "type": "string",
+                    "description": "The search query to execute against your documentation content."
+                  },
+                  "pageSize": {
+                    "type": "number",
+                    "default": 10,
+                    "description": "Number of search results to return. Defaults to 10 if not specified."
+                  },
+                  "filter": {
+                    "type": "object",
+                    "description": "Optional filtering parameters to narrow search results.",
+                    "properties": {
+                      "version": {
+                        "type": "string",
+                        "description": "Filter results by documentation version."
+                      },
+                      "language": {
+                        "type": "string",
+                        "description": "Filter results by content language."
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Search results",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "content": {
+                        "type": "string",
+                        "description": "The matching content from your documentation."
+                      },
+                      "path": {
+                        "type": "string",
+                        "description": "The path or URL to the source document."
+                      },
+                      "metadata": {
+                        "type": "object",
+                        "description": "Additional metadata about the search result, including relevance scoring and other contextual information."
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      }
     }
   },
   "components": {