From 60df211b7a38f66c75bf65d6ff761df409a35eda Mon Sep 17 00:00:00 2001 From: Hagen Echzell Date: Thu, 25 Jun 2026 15:52:20 +0200 Subject: [PATCH] Indicate spec version for changes Signed-off-by: Hagen Echzell --- content/client-server-api/_index.md | 6 +++--- data/api/client-server/wellknown.yaml | 6 +++--- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/content/client-server-api/_index.md b/content/client-server-api/_index.md index c97b1b37..a9231b28 100644 --- a/content/client-server-api/_index.md +++ b/content/client-server-api/_index.md @@ -429,7 +429,7 @@ Instead, they can be reached via HTTPS on the [server name](/appendices/#server- Servers hosting the `.well-known` JSON file SHOULD offer CORS headers, as per the [CORS](#web-browser-clients) section in this specification. -Servers SHOULD also ensure that each 30x redirect, if any, offers such CORS headers. +{{% added-in v="1.19" %}} Servers SHOULD also ensure that each 30x redirect, if any, offers such CORS headers. {{% /boxes/note %}} The flow for auto-discovery is as follows: @@ -437,8 +437,8 @@ The flow for auto-discovery is as follows: 1. Extract the [server name](/appendices/#server-name) from the user's Matrix ID by splitting the Matrix ID at the first colon. 2. Extract the hostname from the server name as described by the [grammar](/appendices/#server-name). -3. Make a GET request to `https://hostname/.well-known/matrix/client`. 30x redirects should be followed, - however redirection loops should be avoided. +3. Make a GET request to `https://hostname/.well-known/matrix/client`. + {{% added-in v="1.19" %}} 30x redirects should be followed, however redirection loops should be avoided. 1. If the returned status code is 404, then `IGNORE`. 2. If the returned status code is not 200, or the response body is empty, then `FAIL_PROMPT`. diff --git a/data/api/client-server/wellknown.yaml b/data/api/client-server/wellknown.yaml index 028d5d63..82cc5130 100644 --- a/data/api/client-server/wellknown.yaml +++ b/data/api/client-server/wellknown.yaml @@ -21,9 +21,9 @@ paths: get: summary: Gets Matrix server discovery information about the domain. description: |- - Gets discovery information about the domain. Clients should follow 30x - redirects, carefully avoiding redirect loops, and use normal X.509 - certificate validation. + Gets discovery information about the domain. + {{% added-in v="1.19" %}} Clients should follow 30x redirects, carefully + avoiding redirect loops, and use normal X.509 certificate validation. The file may include additional keys, which MUST follow the Java package naming convention,