Merge pull request #1106 from matrix-org/dbkr/fix_keys_changes

Fix /keys/changes response to reflect reality

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 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

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