From c891e4a957d4e004517c3fbe5978da4764b7555b Mon Sep 17 00:00:00 2001
From: Travis Ralston <travpc@gmail.com>
Date: Thu, 16 Aug 2018 12:39:47 -0600
Subject: [PATCH] Require the push gateway URL to be of a specific path

---
 api/client-server/pusher.yaml | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/api/client-server/pusher.yaml b/api/client-server/pusher.yaml
index 34050d3f..3bedf866 100644
--- a/api/client-server/pusher.yaml
+++ b/api/client-server/pusher.yaml
@@ -222,7 +222,9 @@ paths:
                     type: string
                     description: |-
                       Required if ``kind`` is ``http``. The URL to use to send
-                      notifications to.
+                      notifications to. MUST be an HTTPS URL with a path pointing
+                      to ``/_matrix/push/v1/notify``.
+                    example: "https://push-gateway.location.here/_matrix/push/v1/notify"
                   format:
                     type: string
                     description: |-