Skip to content

Specify Mutual Rooms (MSC2666)#2367

Open
thetayloredman wants to merge 3 commits intomatrix-org:mainfrom
thetayloredman:msc2666
Open

Specify Mutual Rooms (MSC2666)#2367
thetayloredman wants to merge 3 commits intomatrix-org:mainfrom
thetayloredman:msc2666

Conversation

@thetayloredman
Copy link
Copy Markdown
Contributor

@thetayloredman thetayloredman commented Apr 30, 2026

Spec PR for MSC2666 (Rendered)

Signed-off-by: Logan Devine logan@zirco.dev

Pull Request Checklist

Preview: https://pr2367--matrix-spec-previews.netlify.app

Signed-off-by: Logan Devine <logan@zirco.dev>
Comment thread data/api/client-server/mutual_rooms.yaml
Comment thread data/api/client-server/mutual_rooms.yaml
Comment thread data/api/client-server/mutual_rooms.yaml Outdated
Comment thread data/api/client-server/mutual_rooms.yaml Outdated
Comment thread data/api/client-server/mutual_rooms.yaml Outdated
these events so that clients already have these details to hand, and do
not have to perform extra round trips to query it.

### Mutual Rooms
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I believe that we should clarify the behavior around the next_batch token for the endpoint, like it is explained in the MSC: that it is up to the homeserver, that it must be valid for at least 10 minutes, and that the server may omit newly joined rooms. We could add a "Server behaviour" subsection for this.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Copy Markdown
Collaborator

@zecakeh zecakeh May 2, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks, I believe that we still lack this sentence from the MSC:

When a client uses batch tokens, servers MAY omit rooms that the user joined after the first token was generated.

thetayloredman and others added 2 commits May 1, 2026 10:42
Signed-off-by: Logan Devine <logan@zirco.dev>

Co-authored-by: Kévin Commaille <76261501+zecakeh@users.noreply.github.com>
Signed-off-by: Logan Devine <logan@zirco.dev>
these events so that clients already have these details to hand, and do
not have to perform extra round trips to query it.

### Mutual Rooms
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

According to a discussion in the Matrix Spec& Docs Authoring room, it seems like this section should be under "Modules", rather than under "User Data".


### Mutual Rooms

{{% http-api spec="client-server" api="mutual_rooms" %}}
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We also need to add this to clarify that this section is new:

Suggested change
{{% http-api spec="client-server" api="mutual_rooms" %}}
{{% added-in v="1.19" %}}
{{% http-api spec="client-server" api="mutual_rooms" %}}

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants