Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Clarify differences between /devices and /keys/query #1539

Open
richvdh opened this issue May 24, 2023 · 1 comment
Open

Clarify differences between /devices and /keys/query #1539

richvdh opened this issue May 24, 2023 · 1 comment
Labels
clarification An area where the expected behaviour is understood, but the spec could do with being more explicit

Comments

@richvdh
Copy link
Member

richvdh commented May 24, 2023

Both POST /keys/query and GET /devices return a list of devices, so it's not entirely clear what the differences are.

The primary differences are:

  • /keys/query returns only those devices which have uploaded encryption keys, whereas /devices returns all devices. This in particular is slightly subtle and the spec makes no reference to it.
  • /devices cannot be used to query the device list of another user (it is strictly for the use of the local user to populate a "where am I logged in?" dialogue) whereas /keys/query can be used to get device information for other users
@richvdh richvdh added the clarification An area where the expected behaviour is understood, but the spec could do with being more explicit label May 24, 2023
@clokep
Copy link
Member

clokep commented May 24, 2023

Similarly on the S-S side there is GET /user/devices/{userId} and POST /user/keys/query.

@dkasak had found an old reference to this: matrix-org/matrix-spec-proposals#1576 (comment)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
clarification An area where the expected behaviour is understood, but the spec could do with being more explicit
Projects
None yet
Development

No branches or pull requests

2 participants