v1

latestSwagger 2.0AGPL-3.02026-07-17413281.9 KB
matrix-s2s

Resolve a room alias

Resolves a room alias to a room ID and the servers that can help you join. This is an authenticated federation endpoint: we check the incoming X-Matrix signature first, so a missing or bad one is a 401 before any resolution happens. Past that we pass back whatever status the lookup produced, so a 404 means we genuinely could not resolve it, not that the endpoint is missing.

get/_matrix/federation/v1/query/directory

Query parameters

room_aliasstring required

Room alias to resolve, e.g. #room:server

Response

Room ID and the servers that can help you join

room_idstring
serversstring[]