From 6d843632ff4c9c649ad46146ac5abc72e295a924 Mon Sep 17 00:00:00 2001
From: rzmk <30333942+rzmk@users.noreply.github.com>
Date: Wed, 22 Oct 2025 15:20:07 -0400
Subject: [PATCH] chore(docs): add error callout about facet field for
 package_search

---
 docs/content/docs/package_search.mdx | 18 ++++++++++++++++++
 docs/lib/openapi.yml                 |  6 ++++++
 2 files changed, 24 insertions(+)

diff --git a/docs/content/docs/package_search.mdx b/docs/content/docs/package_search.mdx
index 4a71c1c..1233c29 100644
--- a/docs/content/docs/package_search.mdx
+++ b/docs/content/docs/package_search.mdx
@@ -44,6 +44,18 @@ _openapi:
           - `fq=tags:economy` datasets with the tag *economy*
 
           - `facet.field=["tags"] facet.limit=10 rows=0` top 10 tags
+
+
+          <Callout title="Title" type="error">
+
+          There is an issue for the Body dropdown within this UI where an empty
+          object `{}` is set for the `facet` field.
+
+
+          Please either remove this field by clicking "Open JSON editor" in the
+          Body dropdown or set it to `true` (the default value) or `false`.
+
+          </Callout>
 ---
 
 {/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}
@@ -68,5 +80,11 @@ Examples:
 - `fq=tags:economy` datasets with the tag *economy*
 - `facet.field=["tags"] facet.limit=10 rows=0` top 10 tags
 
+<Callout title="Title" type="error">
+There is an issue for the Body dropdown within this UI where an empty object `{}` is set for the `facet` field.
+
+Please either remove this field by clicking "Open JSON editor" in the Body dropdown or set it to `true` (the default value) or `false`.
+</Callout>
+
 
 <APIPage document={"./lib/openapi.yml"} operations={[{"path":"package_search","method":"post"}]} webhooks={[]} hasHead={false} />
\ No newline at end of file
diff --git a/docs/lib/openapi.yml b/docs/lib/openapi.yml
index 18580ac..d7bbf04 100644
--- a/docs/lib/openapi.yml
+++ b/docs/lib/openapi.yml
@@ -383,6 +383,12 @@ paths:
         - `q=flood` datasets containing the word *flood*, *floods*, or *flooding*
         - `fq=tags:economy` datasets with the tag *economy*
         - `facet.field=["tags"] facet.limit=10 rows=0` top 10 tags
+
+        <Callout title="Title" type="error">
+        There is an issue for the Body dropdown within this UI where an empty object `{}` is set for the `facet` field.
+        
+        Please either remove this field by clicking "Open JSON editor" in the Body dropdown or set it to `true` (the default value) or `false`.
+        </Callout>
       requestBody:
         required: false
         content: