From 552a4c4e1a1e28ab036d449b994b1923c9d04dea Mon Sep 17 00:00:00 2001 From: Hubert Chathi Date: Tue, 18 Apr 2023 16:18:57 -0400 Subject: [PATCH] clarify signatures upload endpoint --- data/api/client-server/cross_signing.yaml | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) diff --git a/data/api/client-server/cross_signing.yaml b/data/api/client-server/cross_signing.yaml index 0ac32cfb..817aeca9 100644 --- a/data/api/client-server/cross_signing.yaml +++ b/data/api/client-server/cross_signing.yaml @@ -149,8 +149,12 @@ paths: x-addedInMatrixVersion: "1.1" summary: Upload cross-signing signatures. description: |- - Publishes cross-signing signatures for the user. The request body is a - map from user ID to key ID to signed JSON object. + Publishes cross-signing signatures for the user. + + The request body is a map from user ID to key ID to signed JSON object. + The signed JSON object must match the key previously uploaded or + retrieved for the given key ID, with the exception of the `signatures` + property, which contains the new signature(s) to add. operationId: uploadCrossSigningSignatures security: - accessToken: [] @@ -158,7 +162,8 @@ paths: - in: body name: signatures description: |- - The signatures to be published. + A map from user ID to key ID to signed JSON objects containing the + signatures to be published. required: true schema: type: object