mirror of
https://github.com/matrix-org/matrix-spec
synced 2026-07-26 15:57:48 +02:00
16b04f9d6c
* Add further normative language in mutual rooms server behaviour Signed-off-by: Johannes Marbach <n0-0ne+github@mailbox.org> * Avoid superfluous MUST Co-authored-by: Hubert Chathi <hubertc@matrix.org> --------- Signed-off-by: Johannes Marbach <n0-0ne+github@mailbox.org> Co-authored-by: Hubert Chathi <hubertc@matrix.org>
20 lines
958 B
Markdown
20 lines
958 B
Markdown
### Mutual Rooms
|
|
|
|
{{% added-in v="1.19" %}}
|
|
|
|
{{% http-api spec="client-server" api="mutual_rooms" %}}
|
|
|
|
#### Server behaviour
|
|
|
|
The server MAY decide that the response to this endpoint is too large, and only return a
|
|
subset of the results. In this case, the server populates the optional field `next_batch`
|
|
with an [opaque identifier](/appendices/#opaque-identifiers). The client can then supply
|
|
the identifier as the `from` query parameter in a subsequent request, along with the original
|
|
`user_id`, to fetch the next batch of responses. This will continue until the server no longer
|
|
inserts `next_batch`, meaning there are no further results.
|
|
|
|
Batch tokens generated by this endpoint SHOULD be valid for at least 10 minutes, after which,
|
|
tokens can expire. Expired tokens SHOULD be handled similar to invalid tokens, and return
|
|
a 400 response. When a client uses batch tokens, servers MAY omit rooms that the user joined
|
|
after the first token was generated.
|