diff --git a/src/modules/search/askContent.ts b/src/modules/search/askContent.ts
index e9e17a2..cdbf41e 100644
--- a/src/modules/search/askContent.ts
+++ b/src/modules/search/askContent.ts
@@ -5,6 +5,12 @@ export interface AskContentProps extends SpaceReputationContextParams {
   query: string;
   sourceTypes?: ("entity" | "comment" | "message")[];
   spaceId?: string;
+  /**
+   * With a `spaceId`, also search every space nested under it (children,
+   * grandchildren — the whole subtree, any depth). Ignored without a `spaceId`.
+   * Defaults to false (exact-space search).
+   */
+  includeChildSpaces?: boolean;
   conversationId?: string;
   limit?: number;
 }
diff --git a/src/modules/search/searchContent.ts b/src/modules/search/searchContent.ts
index 5bcf572..7ff39fe 100644
--- a/src/modules/search/searchContent.ts
+++ b/src/modules/search/searchContent.ts
@@ -7,6 +7,12 @@ export interface SearchContentProps extends SpaceReputationContextParams {
   query: string;
   sourceTypes?: ("entity" | "comment" | "message")[];
   spaceId?: string;
+  /**
+   * With a `spaceId`, also search every space nested under it (children,
+   * grandchildren — the whole subtree, any depth). Ignored without a `spaceId`.
+   * Defaults to false (exact-space search).
+   */
+  includeChildSpaces?: boolean;
   conversationId?: string;
   limit?: number;
 }