You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
matrix-spec-proposals/proposals/3938-remove-keyid-from-keys...

1.5 KiB

MSC3938: Remove deprecated keyId parameters from /keys endpoints

The keyId path parameter on GET /_matrix/key/v2/server/{keyId} and GET /_matrix/key/v2/query/{serverName}/{keyId} has been deprecated since before the Matrix spec was formally versioned (pull request).

The reason for deprecation was primarily that it was never implemented correctly: making a request with a keyId had the same effect as making a request without one.

Proposal

The deprecated keyId path parameter should be removed from GET /_matrix/key/v2/server/{keyId} and GET /_matrix/key/v2/query/{serverName}/{keyId}.

Furthermore, a trailing slash at the end of the endpoint path will no longer be permitted.

The new endpoints will simply be GET /_matrix/key/v2/server and GET /_matrix/key/v2/query/{serverName} respectively, and they will return all available keys for the given server.

Potential issues

This is a breaking change: some servers (such as Synapse, until very recently) may include the {keyId} in outgoing requests.