From 420180a69ddd25d44b1c7c048d809b05683978f4 Mon Sep 17 00:00:00 2001
From: Patrick Cloke <patrickc@matrix.org>
Date: Tue, 3 Mar 2020 12:30:19 -0500
Subject: [PATCH] MSC: Remove query_auth federation endpoint.

---
 .gitignore                                    |  1 +
 ...x-remove-query_auth-federation-endpoint.md | 31 +++++++++++++++++++
 2 files changed, 32 insertions(+)
 create mode 100644 proposals/xxxx-remove-query_auth-federation-endpoint.md

diff --git a/.gitignore b/.gitignore
index 800be2fa..9cc27b85 100644
--- a/.gitignore
+++ b/.gitignore
@@ -12,3 +12,4 @@
 *.swp
 _rendered.rst
 /.vscode/
+/.idea/
diff --git a/proposals/xxxx-remove-query_auth-federation-endpoint.md b/proposals/xxxx-remove-query_auth-federation-endpoint.md
new file mode 100644
index 00000000..7930c5f8
--- /dev/null
+++ b/proposals/xxxx-remove-query_auth-federation-endpoint.md
@@ -0,0 +1,31 @@
+# MSCxxxx: Remove the `query_auth` federation endpoint
+
+The `query_auth` federation endpoint is unused by Synapse and should be removed.
+The current implementation in Synapse is broken and will return a 500 error in
+some situations.
+
+## Proposal
+
+Remove:
+
+* [POST `/_matrix/federation/v1/query_auth/{roomId}/{eventId}`](https://matrix.org/docs/spec/server_server/r0.1.3#post-matrix-federation-v1-query-auth-roomid-eventid)
+
+## Potential issues
+
+Removing this endpoint impacts backwards compatibility.
+
+In practice, removing this endpoint should have minimal impact. Since 1.5.0rc1
+of Synapse this endpoint is not called (see [#6214](https://github.com/matrix-org/synapse/pull/6214)).
+During removal it was noted that the code to call this endpoint was already
+unreachable.
+
+Note that it seems like this was initially supported in Synapse v0.7.0. It is
+not clear at what point it became unused.
+
+## Alternatives
+
+The endpoint could be deprecated in removed in a future version of the specification.
+
+## Security considerations
+
+None.