diff --git a/api/client-server/message_pagination.yaml b/api/client-server/message_pagination.yaml
index 9370325b..005b8fb3 100644
--- a/api/client-server/message_pagination.yaml
+++ b/api/client-server/message_pagination.yaml
@@ -79,7 +79,9 @@ paths:
           type: string
           name: filter
           description: |-
-            A url encoded JSON RoomEventFilter to filter returned events with.
+            A JSON RoomEventFilter to filter returned events with.
+          x-example: |-
+            {"contains_url":true}
       responses:
         200:
           description: A list of messages with a new token to request more.