diff --git a/data/api/client-server/keys.yaml b/data/api/client-server/keys.yaml index fbc4d286..df3c5b85 100644 --- a/data/api/client-server/keys.yaml +++ b/data/api/client-server/keys.yaml @@ -292,8 +292,9 @@ paths: Claims one-time keys for use in pre-key messages. The request contains the user ID, device ID and algorithm name of the - keys that are required. The response contains a key matching this - - either a one-time key, or if none are available, a fallback key. + keys that are required. If a key matching these requirements can be + found, the response contains it. The returned key is a one-time key + if one is available, and otherwise a fallback key. One-time keys are given out in the order that they were uploaded via [/keys/upload](/client-server-api/#post_matrixclientv3keysupload). (All diff --git a/data/api/server-server/user_keys.yaml b/data/api/server-server/user_keys.yaml index d2f5ac58..6df29473 100644 --- a/data/api/server-server/user_keys.yaml +++ b/data/api/server-server/user_keys.yaml @@ -24,8 +24,9 @@ paths: Claims one-time keys for use in pre-key messages. The request contains the user ID, device ID and algorithm name of the - keys that are required. The response contains a key matching this - - either a one-time key, or if none are available, a fallback key. + keys that are required. If a key matching these requirements can be + found, the response contains it. The returned key is a one-time key + if one is available, and otherwise a fallback key. One-time keys are given out in the order that they were uploaded via [/keys/upload](/client-server-api/#post_matrixclientv3keysupload). (All