From 26a7a341f0f56e8ac16edf0b8ee7b57bae26b298 Mon Sep 17 00:00:00 2001
From: Travis Ralston <travpc@gmail.com>
Date: Sun, 26 Aug 2018 21:20:28 -0600
Subject: [PATCH] Mark the filter_id in the response of POST /filter as
 required

---
 api/client-server/filter.yaml | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/api/client-server/filter.yaml b/api/client-server/filter.yaml
index b34da7b6..58d9e55c 100644
--- a/api/client-server/filter.yaml
+++ b/api/client-server/filter.yaml
@@ -91,7 +91,12 @@ paths:
               filter_id:
                 type: string
                 description: |-
-                  The ID of the filter that was created.
+                  The ID of the filter that was created. Cannot start
+                  with a ``{`` as this character is used to determine
+                  if the filter provided is inline JSON or a previously
+                  declared filter by homeservers on some APIs.
+                example: "66696p746572"
+            required: ['filter_id']
       tags:
         - Room participation
   "/user/{userId}/filter/{filterId}":