From bd20feca0a3a240625c53c1d8d7e76d914cf956c Mon Sep 17 00:00:00 2001
From: Kris Penney <kris.penney@flare.io>
Date: Tue, 27 Oct 2026 10:55:06 -0400
Subject: [PATCH 1/2] cookies-search: Document with_subdomains param

---
 docs/api-reference/astp/endpoints/post-cookies-search.mdx | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/docs/api-reference/astp/endpoints/post-cookies-search.mdx b/docs/api-reference/astp/endpoints/post-cookies-search.mdx
index 240f192..7e27f29 100644
--- a/docs/api-reference/astp/endpoints/post-cookies-search.mdx
+++ b/docs/api-reference/astp/endpoints/post-cookies-search.mdx
@@ -81,3 +81,11 @@ See the guide for using this endpoint:
   Order in which you want to browse the cookies. One of `asc` or `desc`.
   It defaults to `asc` which is the recommended way to use the API to obtain newly imported cookies.
 </ParamField>
+
+<ParamField body="with_subdomains" type="boolean" default={false}>
+  When `true`, `domain` is treated as the parent domain and the results also include cookies from its subdomains.
+
+  <Note>
+    This parameter only has an effect if a cookie matching policy is configured for the domain with **Match subdomains** enabled. Without one, only exact matches on `domain` are returned.
+  </Note>
+</ParamField>

From 567f9d84e0440b37e2e5f7617ab613443f17fcfa Mon Sep 17 00:00:00 2001
From: Kris Penney <kris.penney@flare.io>
Date: Tue, 3 Nov 2026 09:05:40 -0500
Subject: [PATCH 2/2] add BetaTag

---
 .../astp/endpoints/post-cookies-search.mdx            |  3 ++-
 docs/snippets/beta-tag.mdx                            |  1 +
 docs/style.css                                        | 11 +++++++++++
 3 files changed, 14 insertions(+), 1 deletion(-)
 create mode 100644 docs/snippets/beta-tag.mdx
 create mode 100644 docs/style.css

diff --git a/docs/api-reference/astp/endpoints/post-cookies-search.mdx b/docs/api-reference/astp/endpoints/post-cookies-search.mdx
index 7e27f29..5ed7601 100644
--- a/docs/api-reference/astp/endpoints/post-cookies-search.mdx
+++ b/docs/api-reference/astp/endpoints/post-cookies-search.mdx
@@ -5,6 +5,7 @@ authMethod: "bearer"
 ---
 
 import GatedAccessFeature from '/snippets/gated-access-feature.mdx';
+import { BetaTag } from '/snippets/beta-tag.mdx';
 
 <GatedAccessFeature name="Account & Session Takeover Prevention (ASTP)" />
 
@@ -82,7 +83,7 @@ See the guide for using this endpoint:
   It defaults to `asc` which is the recommended way to use the API to obtain newly imported cookies.
 </ParamField>
 
-<ParamField body="with_subdomains" type="boolean" default={false}>
+<ParamField body="with_subdomains" type="boolean" default={false} post={[<BetaTag />]}>
   When `true`, `domain` is treated as the parent domain and the results also include cookies from its subdomains.
 
   <Note>
diff --git a/docs/snippets/beta-tag.mdx b/docs/snippets/beta-tag.mdx
new file mode 100644
index 0000000..72a6a57
--- /dev/null
+++ b/docs/snippets/beta-tag.mdx
@@ -0,0 +1 @@
+export const BetaTag = () => <span className="field-beta-pill">beta</span>;
diff --git a/docs/style.css b/docs/style.css
new file mode 100644
index 0000000..719f449
--- /dev/null
+++ b/docs/style.css
@@ -0,0 +1,11 @@
+[data-component-part="field-meta-post"]:has(> .field-beta-pill) {
+  white-space: nowrap;
+  font-weight: 500;
+  background-color: rgb(219 234 254 / 0.5); /* blue-100/50 */
+  color: rgb(37 99 235); /* blue-600 */
+}
+
+.dark [data-component-part="field-meta-post"]:has(> .field-beta-pill) {
+  background-color: rgb(96 165 250 / 0.1); /* blue-400/10 */
+  color: rgb(147 197 253); /* blue-300 */
+}