MAmatrix
End-to-end encryption

Query users with recent device key updates.

Gets a list of users who have updated their device identity keys since a previous sync token.

The server should include in the results any users who:

  • currently share a room with the calling user (ie, both users have membership state join); and
  • added new device identity keys or removed an existing device with identity keys, between from and to.
get/_matrix/client/v3/keys/changes

Request

Query parameters

fromstring required

The desired start point of the list. Should be the next_batch field from a response to an earlier call to /sync. Users who have not uploaded new device identity keys since this point, nor deleted existing devices with identity keys since then, will be excluded from the results.

tostring required

The desired end point of the list. Should be the next_batch field from a recent call to /sync - typically the most recent such call. This may be used by the server as a hint to check its caches are up to date.

Response

The list of users who updated their devices.

changedstring[]

The Matrix User IDs of all users who updated their device identity keys.

leftstring[]

The Matrix User IDs of all users who may have left all the end-to-end encrypted rooms they previously shared with the user.

Example response

{
  "changed": [
    "@alice:example.com",
    "@bob:example.org"
  ],
  "left": [
    "@clara:example.com",
    "@doug:example.org"
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.