From dfc8a2e1845e608bce895faab10e32b980dc7492 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?K=C3=A9vin=20Commaille?=
 <76261501+zecakeh@users.noreply.github.com>
Date: Tue, 22 Nov 2022 16:50:28 +0100
Subject: [PATCH] Fix `POST _matrix/federation/v1/user/keys/claim` response
 schema (#1351)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The syntax was not compliant with the Swagger spec.
It also lacked one level of nesting.

Signed-off-by: Kévin Commaille <zecakeh@tedomum.fr>
---
 .../newsfragments/1351.clarification          |  1 +
 data/api/server-server/user_keys.yaml         | 37 ++++++++++---------
 2 files changed, 21 insertions(+), 17 deletions(-)
 create mode 100644 changelogs/server_server/newsfragments/1351.clarification

diff --git a/changelogs/server_server/newsfragments/1351.clarification b/changelogs/server_server/newsfragments/1351.clarification
new file mode 100644
index 00000000..935332ad
--- /dev/null
+++ b/changelogs/server_server/newsfragments/1351.clarification
@@ -0,0 +1 @@
+Fix `POST _matrix/federation/v1/user/keys/claim` response schema.
diff --git a/data/api/server-server/user_keys.yaml b/data/api/server-server/user_keys.yaml
index efad0056..fe84cbbd 100644
--- a/data/api/server-server/user_keys.yaml
+++ b/data/api/server-server/user_keys.yaml
@@ -76,29 +76,32 @@ paths:
 
                   See the [Client-Server Key Algorithms](/client-server-api/#key-algorithms) section for more information on
                   the Key Object format.
+                # User
                 additionalProperties:
                   type: object
+                  # Device
                   additionalProperties:
-                    type:
-                      - string
-                      - type: object
-                        title: KeyObject
-                        properties:
-                          key:
-                            type: string
-                            description: The key, encoded using unpadded base64.
-                          signatures:
+                    type: object
+                    # Key
+                    additionalProperties:
+                      type: object
+                      title: KeyObject
+                      properties:
+                        key:
+                          type: string
+                          description: The key, encoded using unpadded base64.
+                        signatures:
+                          type: object
+                          title: Signatures
+                          additionalProperties:
                             type: object
-                            title: Signatures
                             additionalProperties:
-                              type: object
-                              additionalProperties:
-                                type: string
-                            description: |-
-                              Signature of the key object.
+                              type: string
+                          description: |-
+                            Signature of the key object.
 
-                              The signature is calculated using the process described at [Signing JSON](/appendices/#signing-json).
-                        required: ['key', 'signatures']
+                            The signature is calculated using the process described at [Signing JSON](/appendices/#signing-json).
+                      required: ['key', 'signatures']
                 example: {
                   "@alice:example.com": {
                     "JLAFKJWSCS": {