diff --git a/content/appendices.md b/content/appendices.md index 926161115..045e6e3f7 100644 --- 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 index 1019abbd0..8ba488e42 100644 --- 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 index 085aa74f5..06b93ddfb 100644 --- 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"