From 53bb1f30d6886861ec87ba33ae8c3236668c418b Mon Sep 17 00:00:00 2001 From: Andrew Morgan Date: Fri, 1 May 2026 11:27:08 +0100 Subject: [PATCH 1/3] Note how to paginate using token returned by `/context` It is unclear without deep familiarity of the spec for how to actually paginate messages given the tokens returned by `/context`. There's no mention of how anywhere else in this endpoint. Thus, a small pointer can go a long way. --- data/api/client-server/event_context.yaml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/data/api/client-server/event_context.yaml b/data/api/client-server/event_context.yaml index 0c927a6d9..3dfdf2527 100644 --- a/data/api/client-server/event_context.yaml +++ b/data/api/client-server/event_context.yaml @@ -79,10 +79,10 @@ paths: properties: start: type: string - description: A token that can be used to paginate backwards with. + description: A token that can be used to paginate backwards with using [`/messages`](#get_matrixclientv3roomsroomidmessages). end: type: string - description: A token that can be used to paginate forwards with. + description: A token that can be used to paginate forwards with using [`/messages`](#get_matrixclientv3roomsroomidmessages). events_before: type: array description: |- From 088a2b5eb3a52a2d0e7d4b2683ee3d8ec9a3cfe7 Mon Sep 17 00:00:00 2001 From: Andrew Morgan Date: Fri, 1 May 2026 11:29:41 +0100 Subject: [PATCH 2/3] newsfile --- changelogs/client_server/newsfragments/2372.clarification | 1 + 1 file changed, 1 insertion(+) create mode 100644 changelogs/client_server/newsfragments/2372.clarification diff --git a/changelogs/client_server/newsfragments/2372.clarification b/changelogs/client_server/newsfragments/2372.clarification new file mode 100644 index 000000000..37faaa597 --- /dev/null +++ b/changelogs/client_server/newsfragments/2372.clarification @@ -0,0 +1 @@ +Clarify how to paginate messages using the pagination tokens returned by `/rooms/{roomId}/context/{eventId}`. \ No newline at end of file From 21b3899a500507238f1bb83c2bfb605b15a0afe1 Mon Sep 17 00:00:00 2001 From: Andrew Morgan <1342360+anoadragon453@users.noreply.github.com> Date: Tue, 5 May 2026 09:32:29 +0000 Subject: [PATCH 3/3] Apply suggestions from code review MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Kévin Commaille <76261501+zecakeh@users.noreply.github.com> --- changelogs/client_server/newsfragments/2372.clarification | 2 +- data/api/client-server/event_context.yaml | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/changelogs/client_server/newsfragments/2372.clarification b/changelogs/client_server/newsfragments/2372.clarification index 37faaa597..94615f81a 100644 --- a/changelogs/client_server/newsfragments/2372.clarification +++ b/changelogs/client_server/newsfragments/2372.clarification @@ -1 +1 @@ -Clarify how to paginate messages using the pagination tokens returned by `/rooms/{roomId}/context/{eventId}`. \ No newline at end of file +Clarify how to paginate messages using the pagination tokens returned by `GET /rooms/{roomId}/context/{eventId}`. \ No newline at end of file diff --git a/data/api/client-server/event_context.yaml b/data/api/client-server/event_context.yaml index 3dfdf2527..a23c1aa72 100644 --- a/data/api/client-server/event_context.yaml +++ b/data/api/client-server/event_context.yaml @@ -79,10 +79,10 @@ paths: properties: start: type: string - description: A token that can be used to paginate backwards with using [`/messages`](#get_matrixclientv3roomsroomidmessages). + description: A token that can be used to paginate backwards with using [`GET /messages`](/client-server-api/#get_matrixclientv3roomsroomidmessages). end: type: string - description: A token that can be used to paginate forwards with using [`/messages`](#get_matrixclientv3roomsroomidmessages). + description: A token that can be used to paginate forwards with using [`GET /messages`](/client-server-api/#get_matrixclientv3roomsroomidmessages). events_before: type: array description: |-