From 26f3f6abde7aa9972a8b57a6a206f3508f100c19 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?K=C3=A9vin=20Commaille?= Date: Thu, 20 Feb 2025 17:34:27 +0100 Subject: [PATCH] Deduplicate RoomKeysUpdateResponse MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit And add a link to the endpoint that is mentionned while we're at it. Signed-off-by: Kévin Commaille --- data/api/client-server/key_backup.yaml | 122 ++++++------------------- 1 file changed, 26 insertions(+), 96 deletions(-) diff --git a/data/api/client-server/key_backup.yaml b/data/api/client-server/key_backup.yaml index 64833f6e..cd597f88 100644 --- a/data/api/client-server/key_backup.yaml +++ b/data/api/client-server/key_backup.yaml @@ -438,22 +438,7 @@ paths: content: application/json: schema: - type: object - title: RoomKeysUpdateResponse - properties: - etag: - description: |- - The new etag value representing stored keys in the backup. - See `GET /room_keys/version/{version}` for more details. - type: string - example: abcdefg - count: - description: The number of keys stored in the backup - type: integer - example: 10 - required: - - etag - - count + $ref: "#/components/schemas/RoomKeysUpdateResponse" "403": description: |- The version specified does not match the current backup version. @@ -571,22 +556,7 @@ paths: content: application/json: schema: - type: object - title: RoomKeysUpdateResponse - properties: - etag: - description: |- - The new etag value representing stored keys in the backup. - See `GET /room_keys/version/{version}` for more details. - type: string - example: abcdefg - count: - description: The number of keys stored in the backup - type: integer - example: 10 - required: - - etag - - count + $ref: "#/components/schemas/RoomKeysUpdateResponse" "404": description: The backup was not found. content: @@ -644,22 +614,7 @@ paths: content: application/json: schema: - type: object - title: RoomKeysUpdateResponse - properties: - etag: - description: |- - The new etag value representing stored keys in the backup. - See `GET /room_keys/version/{version}` for more details. - type: string - example: abcdefg - count: - description: The number of keys stored in the backup - type: integer - example: 10 - required: - - etag - - count + $ref: "#/components/schemas/RoomKeysUpdateResponse" "403": description: |- The version specified does not match the current backup version. @@ -778,22 +733,7 @@ paths: content: application/json: schema: - type: object - title: RoomKeysUpdateResponse - properties: - etag: - description: |- - The new etag value representing stored keys in the backup. - See `GET /room_keys/version/{version}` for more details. - type: string - example: abcdefg - count: - description: The number of keys stored in the backup - type: integer - example: 10 - required: - - etag - - count + $ref: "#/components/schemas/RoomKeysUpdateResponse" "404": description: The backup was not found. content: @@ -866,22 +806,7 @@ paths: content: application/json: schema: - type: object - title: RoomKeysUpdateResponse - properties: - etag: - description: |- - The new etag value representing stored keys in the backup. - See `GET /room_keys/version/{version}` for more details. - type: string - example: abcdefg - count: - description: The number of keys stored in the backup - type: integer - example: 10 - required: - - etag - - count + $ref: "#/components/schemas/RoomKeysUpdateResponse" "403": description: |- The version specified does not match the current backup version. @@ -1007,22 +932,7 @@ paths: content: application/json: schema: - type: object - title: RoomKeysUpdateResponse - properties: - etag: - description: |- - The new etag value representing stored keys in the backup. - See `GET /room_keys/version/{version}` for more details. - type: string - example: abcdefg - count: - description: The number of keys stored in the backup - type: integer - example: 10 - required: - - etag - - count + $ref: "#/components/schemas/RoomKeysUpdateResponse" "404": description: The backup was not found. content: @@ -1056,6 +966,26 @@ servers: basePath: default: /_matrix/client/v3 components: + schemas: + RoomKeysUpdateResponse: + type: object + title: RoomKeysUpdateResponse + properties: + etag: + description: |- + The new etag value representing stored keys in the backup. + + See [`GET /room_keys/version/{version}`](client-server-api/#get_matrixclientv3room_keysversionversion) + for more details. + type: string + example: abcdefg + count: + description: The number of keys stored in the backup + type: integer + example: 10 + required: + - etag + - count securitySchemes: accessTokenQuery: $ref: definitions/security.yaml#/accessTokenQuery