matrix-org / matrix-org/matrix-spec

Federation: wrong endpoint for device list resync

Open
#670 0 comments 0 reactions 0 assignees View on GitHub
A-E2EE A-S2S spec-bug
Dominant language
HTML
Stars
330
Forks
150
Avg merge
2h 21m
Merged PRs (30d)
3

Description

[The federation spec says](https://spec.matrix.org/v1.6/server-server-api/#device-management):

> If a server receives an EDU which refers to a `prev_id` it does not recognise, it must resynchronise its list by calling the `/user/keys/query` API and resume the process

It seems to me that the endpoint that should be used to resync device lists is `/_matrix/federation/v1/user/devices/{userId}`; it's also the one Synapse has always been using afaict.

Contributor guide

Open the contributing guide

Research direction

Start at the device management section of the Matrix server-server specification and compare its resynchronisation instruction with the surrounding federation API definitions. Verify which endpoint is intended, then update the specification reference so it matches the documented device-list resync API.

Written by the indexing model from the issue text.

Assessment

Domain
api, documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.