From 6fb26697e80dd1fcfe6b26f907491d270d211b77 Mon Sep 17 00:00:00 2001 From: Germain Souquet Date: Wed, 12 Jan 2022 09:53:13 +0000 Subject: [PATCH] Marking `from` parameter as optional As per MSC3567, the `from` parameter is now optional for the `/messages` endpoint to allow fetching first or latest room content without having to rely on `/sync` https://github.com/matrix-org/matrix-doc/pull/3567 --- data/api/client-server/message_pagination.yaml | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/data/api/client-server/message_pagination.yaml b/data/api/client-server/message_pagination.yaml index b63f9e17..faa39138 100644 --- a/data/api/client-server/message_pagination.yaml +++ b/data/api/client-server/message_pagination.yaml @@ -57,7 +57,11 @@ paths: This endpoint can also accept a value returned as a `start` token by a previous request to this endpoint, though servers are not required to support this. Clients should not rely on the behaviour. - required: true + + If it is not provided, the homeserver shall return a list of messages + from the first or last (per the value of the `dir` parameter) visible + event in the room history for the requesting user. + required: false x-example: "s345_678_333" - in: query type: string