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

Update ordering behaviour for room directory listing (as per MSC4423) (#2392)

Browse source 
* Update ordering behaviour for room directory listing

As per MSC4423

* Add changelogs
This commit is contained in:
Travis Ralston 2026-06-09 16:05:13 -06:00 committed by GitHub
parent 6897b6bfd5
commit 72cf925609
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
4 changed files with 26 additions and 8 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

1
changelogs/client_server/newsfragments/2392.feature Normal file
View file

@ -0,0 +1 @@
The room directory now returns rooms in a server-defined order rather than largest first, as per [MSC4423](https://github.com/matrix-org/matrix-spec-proposals/pull/4423).

1
changelogs/server_server/newsfragments/2392.feature Normal file
View file

@ -0,0 +1 @@
The room directory now returns rooms in a server-defined order rather than largest first, as per [MSC4423](https://github.com/matrix-org/matrix-spec-proposals/pull/4423).

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

@ -137,8 +137,12 @@ paths:
description: |-
Lists a server's published room directory.
This API returns paginated responses. The rooms are ordered by the number
of joined members, with the largest rooms first.
This API returns paginated responses.
{{% 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
parameters:
- in: query
@ -177,8 +181,12 @@ paths:
description: |-
Lists a server's published room directory with an optional filter.
This API returns paginated responses. The rooms are ordered by the number
of joined members, with the largest rooms first.
This API returns paginated responses.
{{% 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
security:
- accessTokenQuery: []

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

@ -22,8 +22,12 @@ paths:
description: |-
Lists the server's published room directory.
This API returns paginated responses. The rooms are ordered by the number
of joined members, with the largest rooms first.
This API returns paginated responses.
{{% 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,
just those listed on the receiving homeserver's directory.
@ -76,8 +80,12 @@ paths:
description: |-
Lists the server's published room directory with an optional filter.
This API returns paginated responses. The rooms are ordered by the number
of joined members, with the largest rooms first.
This API returns paginated responses.
{{% 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
security:
- signedRequest: []