From 88c459d5490e3c74118d5cfd34038869418d3d98 Mon Sep 17 00:00:00 2001
From: Erik Johnston <erik@matrix.org>
Date: Mon, 26 Oct 2015 13:40:24 +0000
Subject: [PATCH] Add back in login v1 fallback API

---
 specification/client_server_api.rst | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/specification/client_server_api.rst b/specification/client_server_api.rst
index 9e230334..9266002f 100644
--- a/specification/client_server_api.rst
+++ b/specification/client_server_api.rst
@@ -362,6 +362,18 @@ Old V1 API docs: |register|_
 
 {{login_http_api}}
 
+Fallback
+++++++++
+
+Clients cannot be expected to be able to know how to process every single login
+type. If a client determines it does not know how to handle a given login type,
+it should request a login fallback page:
+
+    GET /_matrix/client/api/v1/login/fallback
+
+This returns an HTML and JavaScript page which can perform the entire login
+process.
+
 Changing Password
 +++++++++++++++++
 Request::