MSC4213: Remove server_name parameter

Signed-off-by: Johannes Marbach <n0-0ne+github@mailbox.org>
matrix-org · Jan 21, 2025 · 1a31a12 · 1a31a12
1 parent d0d71d9
commit 1a31a12
Show file tree

Hide file tree

Showing 3 changed files with 2 additions and 52 deletions.
diff --git a/content/appendices.md b/content/appendices.md
@@ -900,8 +900,8 @@ A room (or room permalink) which isn't using a room alias should supply
 at least one server using `via` in the URI's query string. Multiple servers
 can be specified by including multuple `via` parameters.
 
-The values of `via` are intended to be passed along as the `server_name`
-parameters on the [Client Server `/join/{roomIdOrAlias}` API](/client-server-api/#post_matrixclientv3joinroomidoralias).
+The values of `via` are intended to be passed along on the
+[Client Server `/join/{roomIdOrAlias}` API](/client-server-api/#post_matrixclientv3joinroomidoralias).
 
 When generating room links and permalinks, the application should pick
 servers which have a high probability of being in the room in the

diff --git a/data/api/client-server/joining.yaml b/data/api/client-server/joining.yaml
@@ -137,31 +137,6 @@ paths:
           example: "#monkeys:matrix.org"
           schema:
             type: string
-        - in: query
-          name: server_name
-          deprecated: true
-          x-changedInMatrixVersion:
-            "1.12": |-
-              This parameter has been deprecated in favour of `via` and will be removed in
-              a future version of the spec.
-
-              Clients SHOULD use `via` when the homeserver they're talking to supports it.
-              To do this, they MAY either detect server support through the supported spec
-              versions in [`/_matrix/client/versions`](/client-server-api/#get_matrixclientversions)
-              or always include both parameters with identical values.
-
-              Homeservers MUST ignore all `server_name` parameters if any `via` parameters
-              are supplied.
-          description: |-
-            The servers to attempt to join the room through. One of the servers
-            must be participating in the room.
-          example:
-            - matrix.org
-            - elsewhere.ca
-          schema:
-            type: array
-            items:
-              type: string
         - in: query
           name: via
           x-addedInMatrixVersion: "1.12"

diff --git a/data/api/client-server/knocking.yaml b/data/api/client-server/knocking.yaml
@@ -48,31 +48,6 @@ paths:
           example: "#monkeys:matrix.org"
           schema:
             type: string
-        - in: query
-          name: server_name
-          deprecated: true
-          x-changedInMatrixVersion:
-            "1.12": |-
-              This parameter has been deprecated in favour of `via` and will be removed in
-              a future version of the spec.
-
-              Clients SHOULD use `via` when the homeserver they're talking to supports it.
-              To do this, they MAY either detect server support through the supported spec
-              versions in [`/_matrix/client/versions`](/client-server-api/#get_matrixclientversions)
-              or always include both parameters with identical values.
-
-              Homeservers MUST ignore all `server_name` parameters if any `via` parameters
-              are supplied.
-          description: |-
-            The servers to attempt to knock on the room through. One of the servers
-            must be participating in the room.
-          example:
-            - matrix.org
-            - elsewhere.ca
-          schema:
-            type: array
-            items:
-              type: string
         - in: query
           name: via
           x-addedInMatrixVersion: "1.12"