Filip/matrix-spec
1
0
Fork 0
mirror of https://github.com/matrix-org/matrix-spec synced 2026-07-01 19:57:48 +02:00
Code Issues Actions 3 Packages Projects Releases Wiki Activity

Update ordering behaviour for room directory listing

Browse source 
As per MSC4423
This commit is contained in:
Travis Ralston 2026-06-05 14:04:06 -06:00
parent 2b68fd935c
commit 57590f62a3
2 changed files with 24 additions and 8 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

16
data/api/client-server/list_public_rooms.yaml
View file

@ -137,8 +137,12 @@ paths:
description: |- description: |-
Lists a server's published room directory. Lists a server's published room directory.
This API returns paginated responses. The rooms are ordered by the number This API returns paginated responses.
of joined members, with the largest rooms first.
{{% changed-in v="1.19" %}} The server determines the order of the rooms
returned by this endpoint. Previously, rooms were ordered with the largest
joined member count first. Continuing to order by largest first or another
stable order is recommended.
operationId: getPublicRooms operationId: getPublicRooms
parameters: parameters:
- in: query - in: query
@ -177,8 +181,12 @@ paths:
description: |- description: |-
Lists a server's published room directory with an optional filter. Lists a server's published room directory with an optional filter.
This API returns paginated responses. The rooms are ordered by the number This API returns paginated responses.
of joined members, with the largest rooms first.
{{% changed-in v="1.19" %}} The server determines the order of the rooms
returned by this endpoint. Previously, rooms were ordered with the largest
joined member count first. Continuing to order by largest first or another
stable order is recommended.
operationId: queryPublicRooms operationId: queryPublicRooms
security: security:
- accessTokenQuery: [] - accessTokenQuery: []

16
data/api/server-server/public_rooms.yaml
View file

@ -22,8 +22,12 @@ paths:
description: |- description: |-
Lists the server's published room directory. Lists the server's published room directory.
This API returns paginated responses. The rooms are ordered by the number This API returns paginated responses.
of joined members, with the largest rooms first.
{{% changed-in v="1.19" %}} The server determines the order of the rooms
returned by this endpoint. Previously, rooms were ordered with the largest
joined member count first. Continuing to order by largest first or another
stable order is recommended.
This SHOULD not return rooms that are listed on another homeserver's directory, This SHOULD not return rooms that are listed on another homeserver's directory,
just those listed on the receiving homeserver's directory. just those listed on the receiving homeserver's directory.
@ -76,8 +80,12 @@ paths:
description: |- description: |-
Lists the server's published room directory with an optional filter. Lists the server's published room directory with an optional filter.
This API returns paginated responses. The rooms are ordered by the number This API returns paginated responses.
of joined members, with the largest rooms first.
{{% changed-in v="1.19" %}} The server determines the order of the rooms
returned by this endpoint. Previously, rooms were ordered with the largest
joined member count first. Continuing to order by largest first or another
stable order is recommended.
operationId: queryPublicRooms operationId: queryPublicRooms
security: security:
- signedRequest: [] - signedRequest: []