From 16b04f9d6c132773f1c50e7c4a7a707f02cd9b30 Mon Sep 17 00:00:00 2001 From: Johannes Marbach Date: Thu, 16 Jul 2026 17:18:09 +0200 Subject: [PATCH] Add further normative language in mutual rooms server behaviour (#2407) * Add further normative language in mutual rooms server behaviour Signed-off-by: Johannes Marbach * Avoid superfluous MUST Co-authored-by: Hubert Chathi --------- Signed-off-by: Johannes Marbach Co-authored-by: Hubert Chathi --- changelogs/client_server/newsfragments/2407.clarification | 1 + content/client-server-api/modules/mutual_rooms.md | 6 +++--- 2 files changed, 4 insertions(+), 3 deletions(-) create mode 100644 changelogs/client_server/newsfragments/2407.clarification diff --git a/changelogs/client_server/newsfragments/2407.clarification b/changelogs/client_server/newsfragments/2407.clarification new file mode 100644 index 00000000..1bc654e8 --- /dev/null +++ b/changelogs/client_server/newsfragments/2407.clarification @@ -0,0 +1 @@ +Add further normative language in mutual rooms server behaviour. diff --git a/content/client-server-api/modules/mutual_rooms.md b/content/client-server-api/modules/mutual_rooms.md index 162e9c71..511f1573 100644 --- a/content/client-server-api/modules/mutual_rooms.md +++ b/content/client-server-api/modules/mutual_rooms.md @@ -6,9 +6,9 @@ #### 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 should populate the optional field `next_batch` -with an [opaque identifier](/appendices/#opaque-identifiers). The client may then supply +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.