diff --git a/api/client-server/event_context.yaml b/api/client-server/event_context.yaml
index e0c74cbf..b1c9956c 100644
--- a/api/client-server/event_context.yaml
+++ b/api/client-server/event_context.yaml
@@ -63,10 +63,9 @@ paths:
           name: filter
           type: string
           description: |-
-            The ID of a filter created using the filter API or a filter JSON
-            object encoded as a string. The server will detect whether it is
-            an ID or a JSON object by whether the first character is a ``"{"``
-            open brace.
+            A JSON ``RoomEventFilter`` to filter the returned events with. The
+            filter can be applied before or/and after the ``limit`` parameter -
+            whichever the homeserver prefers.
 
             See `Filtering <#filtering>`_ for more information.
           x-example: "66696p746572"