diff --git a/api/client-server/search.yaml b/api/client-server/search.yaml
index e4118c32b5..6feb577836 100644
--- a/api/client-server/search.yaml
+++ b/api/client-server/search.yaml
@@ -41,7 +41,7 @@ paths:
           type: string
           description: |-
             The point to return events from. If given, this should be a
-            `next_batch` result from a previous call to this endpoint.
+            ``next_batch`` result from a previous call to this endpoint.
           x-example: "YWxsCgpOb25lLDM1ODcwOA"
         - in: body
           name: body
@@ -95,6 +95,7 @@ paths:
                         # for now :/
                         description: |-
                           This takes a `filter`_.
+                        $ref: "definitions/room_event_filter.yaml"
                       order_by:
                         title: "Ordering"
                         type: string
diff --git a/changelogs/client_server/newsfragments/1577.clarification b/changelogs/client_server/newsfragments/1577.clarification
new file mode 100644
index 0000000000..aec3248fea
--- /dev/null
+++ b/changelogs/client_server/newsfragments/1577.clarification
@@ -0,0 +1 @@
+Clarify the filter object schema used in room searching.