From ca09415e803cda522c0166dfb78cc62355aef40a Mon Sep 17 00:00:00 2001
From: David Baker <dave@matrix.org>
Date: Wed, 17 Jan 2018 11:16:48 +0000
Subject: [PATCH 1/3] Fix /keys/changes response to reflect reality

---
 api/client-server/keys.yaml | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/api/client-server/keys.yaml b/api/client-server/keys.yaml
index 317a1295..1b821dea 100644
--- a/api/client-server/keys.yaml
+++ b/api/client-server/keys.yaml
@@ -336,7 +336,7 @@ paths:
           schema:
             type: object
             properties:
-              changes:
+              changed:
                 type: array
                 items:
                   type: string
@@ -344,5 +344,14 @@ paths:
                   The Matrix User IDs of all users who updated their device
                   identity keys.
                 example: ["@alice:example.com", "@bob:example.org"]
+              left:
+                type: array
+                items:
+                  type: string
+                description: |-
+                  The Matrix User IDs of all users who may have left an
+                  end-to-end encrypted room that the user is joined to.
+                  identity keys.
+                example: ["@clara:example.com", "@doug:example.org"]
       tags:
         - End-to-end encryption

From 2a9a9e757e10da1b8583afb836ada956b2468a80 Mon Sep 17 00:00:00 2001
From: David Baker <dave@matrix.org>
Date: Wed, 17 Jan 2018 11:20:26 +0000
Subject: [PATCH 2/3] add changelog

---
 changelogs/client_server.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/changelogs/client_server.rst b/changelogs/client_server.rst
index 0f6d6e91..27f37d57 100644
--- a/changelogs/client_server.rst
+++ b/changelogs/client_server.rst
@@ -13,6 +13,8 @@ Unreleased changes
   - Mark ``home_server`` return field for ``/login`` and ``/register``
     endpoints as deprecated
     (`#1097 <https://github.com/matrix-org/matrix-doc/pull/1097>`_).
+  - Fix response format of ``/keys/changes`` endpoint
+    (`#1106 <https://github.com/matrix-org/matrix-doc/pull/1106>`_)
 
 - Changes to the API which will be backwards-compatible for clients:
   - Add 'token' parameter to /keys/query endpoint

From fa0eb2405f349c8af61fd8616cc6148fc3f47b42 Mon Sep 17 00:00:00 2001
From: David Baker <dave@matrix.org>
Date: Wed, 17 Jan 2018 11:25:09 +0000
Subject: [PATCH 3/3] all rooms, not any, and remove extra words

---
 api/client-server/keys.yaml | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/api/client-server/keys.yaml b/api/client-server/keys.yaml
index 1b821dea..5fb6318e 100644
--- a/api/client-server/keys.yaml
+++ b/api/client-server/keys.yaml
@@ -349,9 +349,9 @@ paths:
                 items:
                   type: string
                 description: |-
-                  The Matrix User IDs of all users who may have left an
-                  end-to-end encrypted room that the user is joined to.
-                  identity keys.
+                  The Matrix User IDs of all users who may have left all
+                  the end-to-end encrypted rooms they previously shared
+                  with the user.
                 example: ["@clara:example.com", "@doug:example.org"]
       tags:
         - End-to-end encryption