Update client-server API endpoints to move from r0 to v3 (plus whitespace fixes) (#3421)

* Blind find & replace all on client major version -> v3 * Fix up bad replacements * Fix anchors for r0->v3 * Changelog
2021-10-12 11:07:01 -06:00 · 2021-10-12 11:07:01 -06:00 · 95d850c418
commit 95d850c418
parent 2d98cd3084
69 changed files with 206 additions and 210 deletions
--- a/data/api/client-server/account-data.yaml
+++ b/data/api/client-server/account-data.yaml
@ -19,7 +19,7 @@ host: localhost:8008
 schemes:
  - https
  - http
-basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/client/v3
 consumes:
  - application/json
 produces:
--- a/data/api/client-server/admin.yaml
+++ b/data/api/client-server/admin.yaml
@ -19,7 +19,7 @@ host: localhost:8008
 schemes:
  - https
  - http
-basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/client/v3
 consumes:
  - application/json
 produces:
--- a/data/api/client-server/administrative_contact.yaml
+++ b/data/api/client-server/administrative_contact.yaml
@ -20,7 +20,7 @@ host: localhost:8008
 schemes:
  - https
  - http
-basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/client/v3
 consumes:
  - application/json
 produces:
@ -427,7 +427,7 @@ paths:
        already associated with an account on this homeserver. This API should
        be used to request validation tokens when adding an email address to an
        account. This API's parameters and response are identical to that of
-        the [`/register/email/requestToken`](/client-server-api/#post_matrixclientr0registeremailrequesttoken)
+        the [`/register/email/requestToken`](/client-server-api/#post_matrixclientv3registeremailrequesttoken)
        endpoint. The homeserver should validate
        the email itself, either by sending a validation email itself or by using
        a service it has control over.
@ -480,7 +480,7 @@ paths:
        already associated with an account on this homeserver. This API should
        be used to request validation tokens when adding a phone number to an
        account. This API's parameters and response are identical to that of
-        the [`/register/msisdn/requestToken`](/client-server-api/#post_matrixclientr0registermsisdnrequesttoken)
+        the [`/register/msisdn/requestToken`](/client-server-api/#post_matrixclientv3registermsisdnrequesttoken)
        endpoint. The homeserver should validate
        the phone number itself, either by sending a validation message itself or by using
        a service it has control over.
--- a/data/api/client-server/appservice_room_directory.yaml
+++ b/data/api/client-server/appservice_room_directory.yaml
@ -19,7 +19,7 @@ host: localhost:8008
 schemes:
  - https
  - http
-basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/client/v3
 consumes:
  - application/json
 produces:
--- a/data/api/client-server/banning.yaml
+++ b/data/api/client-server/banning.yaml
@ -19,7 +19,7 @@ host: localhost:8008
 schemes:
  - https
  - http
-basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/client/v3
 consumes:
  - application/json
 produces:
--- a/data/api/client-server/capabilities.yaml
+++ b/data/api/client-server/capabilities.yaml
@ -19,7 +19,7 @@ host: localhost:8008
 schemes:
  - https
  - http
-basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/client/v3
 produces:
  - application/json
 securityDefinitions:
--- a/data/api/client-server/content-repo.yaml
+++ b/data/api/client-server/content-repo.yaml
@ -20,7 +20,7 @@ host: localhost:8008
 schemes:
  - https
  - http
-basePath: /_matrix/media/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/media/v3
 consumes:
  - application/json
  - "*/*"
--- a/data/api/client-server/create_room.yaml
+++ b/data/api/client-server/create_room.yaml
@ -20,7 +20,7 @@ host: localhost:8008
 schemes:
  - https
  - http
-basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/client/v3
 consumes:
  - application/json
 produces:
--- a/data/api/client-server/cross_signing.yaml
+++ b/data/api/client-server/cross_signing.yaml
@ -19,7 +19,7 @@ host: localhost:8008
 schemes:
  - https
  - http
-basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/client/v3
 consumes:
  - application/json
 produces:
--- a/data/api/client-server/definitions/timeline_batch.yaml
+++ b/data/api/client-server/definitions/timeline_batch.yaml
@ -21,7 +21,7 @@ properties:
    type: boolean
  prev_batch:
    description: A token that can be supplied to the `from` parameter of the
-      [`/rooms/<room_id>/messages`](#get_matrixclientr0roomsroomidmessages)
+      [`/rooms/<room_id>/messages`](#get_matrixclientv3roomsroomidmessages)
      endpoint in order to retrieve earlier events.

      If no earlier events are available, this property may be omitted from
--- a/data/api/client-server/device_management.yaml
+++ b/data/api/client-server/device_management.yaml
@ -20,7 +20,7 @@ host: localhost:8008
 schemes:
  - https
  - http
-basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/client/v3
 consumes:
  - application/json
 produces:
--- a/data/api/client-server/directory.yaml
+++ b/data/api/client-server/directory.yaml
@ -19,7 +19,7 @@ host: localhost:8008
 schemes:
  - https
  - http
-basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/client/v3
 consumes:
  - application/json
 produces:
--- a/data/api/client-server/event_context.yaml
+++ b/data/api/client-server/event_context.yaml
@ -19,7 +19,7 @@ host: localhost:8008
 schemes:
  - https
  - http
-basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/client/v3
 consumes:
  - application/json
 produces:
--- a/data/api/client-server/filter.yaml
+++ b/data/api/client-server/filter.yaml
@ -18,7 +18,7 @@ info:
 host: localhost:8008
 schemes:
  - https
-basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/client/v3
 consumes:
  - application/json
 produces:
--- a/data/api/client-server/inviting.yaml
+++ b/data/api/client-server/inviting.yaml
@ -19,7 +19,7 @@ host: localhost:8008
 schemes:
  - https
  - http
-basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/client/v3
 consumes:
  - application/json
 produces:
@ -36,7 +36,7 @@ paths:
        *Note that there are two forms of this API, which are documented separately.
        This version of the API requires that the inviter knows the Matrix
        identifier of the invitee. The other is documented in the*
-        [third party invites section](/client-server-api/#post_matrixclientr0roomsroomidinvite-1).
+        [third party invites section](/client-server-api/#post_matrixclientv3roomsroomidinvite-1).

        This API invites a user to participate in a particular room.
        They do not start participating in the room until they actually join the
--- a/data/api/client-server/joining.yaml
+++ b/data/api/client-server/joining.yaml
@ -19,7 +19,7 @@ host: localhost:8008
 schemes:
  - https
  - http
-basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/client/v3
 consumes:
  - application/json
 produces:
@ -40,8 +40,8 @@ paths:
        events associated with the room until the user leaves the room.

        After a user has joined a room, the room will appear as an entry in the
-        response of the [`/initialSync`](/client-server-api/#get_matrixclientr0initialsync)
-        and [`/sync`](/client-server-api/#get_matrixclientr0sync) APIs.
+        response of the [`/initialSync`](/client-server-api/#get_matrixclientv3initialsync)
+        and [`/sync`](/client-server-api/#get_matrixclientv3sync) APIs.
      operationId: joinRoomById
      security:
        - accessToken: []
@ -117,8 +117,8 @@ paths:
        events associated with the room until the user leaves the room.

        After a user has joined a room, the room will appear as an entry in the
-        response of the [`/initialSync`](/client-server-api/#get_matrixclientr0initialsync)
-        and [`/sync`](/client-server-api/#get_matrixclientr0sync) APIs.
+        response of the [`/initialSync`](/client-server-api/#get_matrixclientv3initialsync)
+        and [`/sync`](/client-server-api/#get_matrixclientv3sync) APIs.
      operationId: joinRoom
      security:
        - accessToken: []
--- a/data/api/client-server/key_backup.yaml
+++ b/data/api/client-server/key_backup.yaml
@ -19,7 +19,7 @@ host: localhost:8008
 schemes:
  - https
  - http
-basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/client/v3
 consumes:
  - application/json
 produces:
@ -170,7 +170,7 @@ paths:
          description: |-
            The backup version to get, as returned in the `version` parameter
            of the response in
-            [`POST /_matrix/client/r0/room_keys/version`](/client-server/#post_matrixclientr0room_keysversion)
+            [`POST /_matrix/client/r0/room_keys/version`](/client-server/#post_matrixclientv3room_keysversion)
            or this endpoint.
          required: true
          x-example: "1"
@ -252,8 +252,8 @@ paths:
          description: |-
            The backup version to update, as returned in the `version`
            parameter in the response of
-            [`POST /_matrix/client/r0/room_keys/version`](/client-server-api/#post_matrixclientr0room_keysversion)
-            or [`GET /_matrix/client/r0/room_keys/version/{version}`](/client-server-api/#get_matrixclientr0room_keysversionversion).
+            [`POST /_matrix/client/r0/room_keys/version`](/client-server-api/#post_matrixclientv3room_keysversion)
+            or [`GET /_matrix/client/r0/room_keys/version/{version}`](/client-server-api/#get_matrixclientv3room_keysversionversion).
          required: true
          x-example: "1"
        - in: body
@ -341,8 +341,8 @@ paths:
          description: |-
            The backup version to delete, as returned in the `version`
            parameter in the response of
-            [`POST /_matrix/client/r0/room_keys/version`](/client-server-api/#post_matrixclientr0room_keysversion)
-            or [`GET /_matrix/client/r0/room_keys/version/{version}`](/client-server-api/#get_matrixclientr0room_keysversionversion).
+            [`POST /_matrix/client/r0/room_keys/version`](/client-server-api/#post_matrixclientv3room_keysversion)
+            or [`GET /_matrix/client/r0/room_keys/version/{version}`](/client-server-api/#get_matrixclientv3room_keysversionversion).
          required: true
          x-example: "1"
      responses:
--- a/data/api/client-server/keys.yaml
+++ b/data/api/client-server/keys.yaml
@ -21,7 +21,7 @@ host: localhost:8008
 schemes:
  - https
  - http
-basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/client/v3
 consumes:
  - application/json
 produces:
@ -437,7 +437,7 @@ paths:
          type: string
          description: |-
             The desired start point of the list. Should be the `next_batch` field
-             from a response to an earlier call to [`/sync`](/client-server-api/#get_matrixclientr0sync). Users who have not
+             from a response to an earlier call to [`/sync`](/client-server-api/#get_matrixclientv3sync). Users who have not
             uploaded new device identity keys since this point, nor deleted
             existing devices with identity keys since then, will be excluded
             from the results.
@ -448,7 +448,7 @@ paths:
          type: string
          description: |-
             The desired end point of the list. Should be the `next_batch`
-             field from a recent call to [`/sync`](/client-server-api/#get_matrixclientr0sync) - typically the most recent
+             field from a recent call to [`/sync`](/client-server-api/#get_matrixclientv3sync) - typically the most recent
             such call. This may be used by the server as a hint to check its
             caches are up to date.
          required: true
--- a/data/api/client-server/kicking.yaml
+++ b/data/api/client-server/kicking.yaml
@ -19,7 +19,7 @@ host: localhost:8008
 schemes:
  - https
  - http
-basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/client/v3
 consumes:
  - application/json
 produces:
--- a/data/api/client-server/knocking.yaml
+++ b/data/api/client-server/knocking.yaml
@ -19,7 +19,7 @@ host: localhost:8008
 schemes:
  - https
  - http
-basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/client/v3
 consumes:
  - application/json
 produces:
@ -45,7 +45,7 @@ paths:
        history visibility to the user.

        The knock will appear as an entry in the response of the
-        [`/sync`](/client-server-api/#get_matrixclientr0sync) API.
+        [`/sync`](/client-server-api/#get_matrixclientv3sync) API.
      operationId: knockRoom
      security:
        - accessToken: []
--- a/data/api/client-server/leaving.yaml
+++ b/data/api/client-server/leaving.yaml
@ -19,7 +19,7 @@ host: localhost:8008
 schemes:
  - https
  - http
-basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/client/v3
 consumes:
  - application/json
 produces:
--- a/data/api/client-server/list_joined_rooms.yaml
+++ b/data/api/client-server/list_joined_rooms.yaml
@ -19,7 +19,7 @@ host: localhost:8008
 schemes:
  - https
  - http
-basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/client/v3
 consumes:
  - application/json
 produces:
--- a/data/api/client-server/list_public_rooms.yaml
+++ b/data/api/client-server/list_public_rooms.yaml
@ -19,7 +19,7 @@ host: localhost:8008
 schemes:
  - https
  - http
-basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/client/v3
 consumes:
  - application/json
 produces:
--- a/data/api/client-server/login.yaml
+++ b/data/api/client-server/login.yaml
@ -20,7 +20,7 @@ host: localhost:8008
 schemes:
  - https
  - http
-basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/client/v3
 consumes:
  - application/json
 produces:
--- a/data/api/client-server/logout.yaml
+++ b/data/api/client-server/logout.yaml
@ -19,7 +19,7 @@ host: localhost:8008
 schemes:
  - https
  - http
-basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/client/v3
 consumes:
  - application/json
 produces:
--- a/data/api/client-server/message_pagination.yaml
+++ b/data/api/client-server/message_pagination.yaml
@ -19,7 +19,7 @@ host: localhost:8008
 schemes:
  - https
  - http
-basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/client/v3
 consumes:
  - application/json
 produces:
@ -55,7 +55,7 @@ paths:
            or from an `end` token returned by a previous request to this endpoint.

            This endpoint can also accept a value returned as a `start` token
-            by a previous request to this endpoint, though servers are not 
+            by a previous request to this endpoint, though servers are not
            required to support this. Clients should not rely on the behaviour.
          required: true
          x-example: "s345_678_333"
--- a/data/api/client-server/notifications.yaml
+++ b/data/api/client-server/notifications.yaml
@ -20,7 +20,7 @@ host: localhost:8008
 schemes:
  - https
  - http
-basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/client/v3
 consumes:
  - application/json
 produces:
--- a/data/api/client-server/old_sync.yaml
+++ b/data/api/client-server/old_sync.yaml
@ -19,7 +19,7 @@ host: localhost:8008
 schemes:
  - https
  - http
-basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/client/v3
 consumes:
  - application/json
 produces:
@ -35,7 +35,7 @@ paths:
        block until an event is received, or until the `timeout` is reached.

        This endpoint was deprecated in r0 of this specification. Clients
-        should instead call the [`/sync`](/client-server-api/#get_matrixclientr0sync)
+        should instead call the [`/sync`](/client-server-api/#get_matrixclientv3sync)
        endpoint with a `since` parameter. See
        the [migration guide](https://matrix.org/docs/guides/migrating-from-client-server-api-v-1#deprecated-endpoints).
      operationId: getEvents
@ -101,7 +101,7 @@ paths:
        number of messages per room to return.

        This endpoint was deprecated in r0 of this specification. Clients
-        should instead call the [`/sync`](/client-server-api/#get_matrixclientr0sync)
+        should instead call the [`/sync`](/client-server-api/#get_matrixclientv3sync)
        endpoint with no `since` parameter. See
        the [migration guide](https://matrix.org/docs/guides/migrating-from-client-server-api-v-1#deprecated-endpoints).
      operationId: initialSync
@ -239,7 +239,7 @@ paths:
                          description: |-
                            A token which correlates to the start of `chunk`.
                            Can be passed to
-                            [`/rooms/<room_id>/messages`](#get_matrixclientr0roomsroomidmessages)
+                            [`/rooms/<room_id>/messages`](#get_matrixclientv3roomsroomidmessages)
                            to retrieve earlier events.

                            If no earlier events are available, this property may be omitted from
@ -249,7 +249,7 @@ paths:
                          description: |-
                            A token which correlates to the end of `chunk`.
                            Can be passed to
-                            [`/rooms/<room_id>/messages`](#get_matrixclientr0roomsroomidmessages)
+                            [`/rooms/<room_id>/messages`](#get_matrixclientv3roomsroomidmessages)
                            to retrieve later events.
                        chunk:
                          type: array
@ -318,8 +318,8 @@ paths:

        This endpoint was deprecated in r0 of this specification. Clients
        should instead call the
-        [/rooms/{roomId}/event/{eventId}](/client-server-api/#get_matrixclientr0roomsroomideventeventid) API
-        or the [/rooms/{roomId}/context/{eventId](/client-server-api/#get_matrixclientr0roomsroomidcontexteventid) API.
+        [/rooms/{roomId}/event/{eventId}](/client-server-api/#get_matrixclientv3roomsroomideventeventid) API
+        or the [/rooms/{roomId}/context/{eventId](/client-server-api/#get_matrixclientv3roomsroomidcontexteventid) API.
      operationId: getOneEvent
      security:
        - accessToken: []
--- a/data/api/client-server/openid.yaml
+++ b/data/api/client-server/openid.yaml
@ -19,7 +19,7 @@ host: localhost:8008
 schemes:
  - https
  - http
-basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/client/v3
 consumes:
  - application/json
 produces:
--- a/data/api/client-server/peeking_events.yaml
+++ b/data/api/client-server/peeking_events.yaml
@ -19,7 +19,7 @@ host: localhost:8008
 schemes:
  - https
  - http
-basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/client/v3
 consumes:
  - application/json
 produces:
--- a/data/api/client-server/presence.yaml
+++ b/data/api/client-server/presence.yaml
@ -19,7 +19,7 @@ host: localhost:8008
 schemes:
  - https
  - http
-basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/client/v3
 consumes:
  - application/json
 produces:
--- a/data/api/client-server/profile.yaml
+++ b/data/api/client-server/profile.yaml
@ -19,7 +19,7 @@ host: localhost:8008
 schemes:
  - https
  - http
-basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/client/v3
 consumes:
  - application/json
 produces:
--- a/data/api/client-server/pusher.yaml
+++ b/data/api/client-server/pusher.yaml
@ -20,7 +20,7 @@ host: localhost:8008
 schemes:
  - https
  - http
-basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/client/v3
 consumes:
  - application/json
 produces:
--- a/data/api/client-server/pushrules.yaml
+++ b/data/api/client-server/pushrules.yaml
@ -19,7 +19,7 @@ host: localhost:8008
 schemes:
  - https
  - http
-basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/client/v3
 consumes:
  - application/json
 produces:
--- a/data/api/client-server/read_markers.yaml
+++ b/data/api/client-server/read_markers.yaml
@ -19,7 +19,7 @@ host: localhost:8008
 schemes:
  - https
  - http
-basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/client/v3
 consumes:
  - application/json
 produces:
--- a/data/api/client-server/receipts.yaml
+++ b/data/api/client-server/receipts.yaml
@ -19,7 +19,7 @@ host: localhost:8008
 schemes:
  - https
  - http
-basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/client/v3
 consumes:
  - application/json
 produces:
--- a/data/api/client-server/redaction.yaml
+++ b/data/api/client-server/redaction.yaml
@ -19,7 +19,7 @@ host: localhost:8008
 schemes:
  - https
  - http
-basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/client/v3
 consumes:
  - application/json
 produces:
--- a/data/api/client-server/registration.yaml
+++ b/data/api/client-server/registration.yaml
@ -19,7 +19,7 @@ host: localhost:8008
 schemes:
  - https
  - http
-basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/client/v3
 consumes:
  - application/json
 produces:
@ -393,7 +393,7 @@ paths:
        `/account/password` endpoint.

        This API's parameters and response are identical to that of the
-        [`/register/email/requestToken`](/client-server-api/#post_matrixclientr0registeremailrequesttoken)
+        [`/register/email/requestToken`](/client-server-api/#post_matrixclientv3registeremailrequesttoken)
        endpoint, except that
        `M_THREEPID_NOT_FOUND` may be returned if no account matching the
        given email address could be found. The server may instead send an
@ -450,7 +450,7 @@ paths:
        `/account/password` endpoint.

        This API's parameters and response are identical to that of the
-        [`/register/msisdn/requestToken`](/client-server-api/#post_matrixclientr0registermsisdnrequesttoken)
+        [`/register/msisdn/requestToken`](/client-server-api/#post_matrixclientv3registermsisdnrequesttoken)
        endpoint, except that
        `M_THREEPID_NOT_FOUND` may be returned if no account matching the
        given phone number could be found. The server may instead send the SMS
--- a/data/api/client-server/report_content.yaml
+++ b/data/api/client-server/report_content.yaml
@ -19,7 +19,7 @@ host: localhost:8008
 schemes:
  - https
  - http
-basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/client/v3
 consumes:
  - application/json
 produces:
--- a/data/api/client-server/room_initial_sync.yaml
+++ b/data/api/client-server/room_initial_sync.yaml
@ -6,7 +6,7 @@ host: localhost:8008
 schemes:
  - https
  - http
-basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/client/v3
 consumes:
  - application/json
 produces:
@ -22,7 +22,7 @@ paths:

        This endpoint was deprecated in r0 of this specification. There is no
        direct replacement; the relevant information is returned by the
-        [`/sync`](/client-server-api/#get_matrixclientr0sync) API. See the
+        [`/sync`](/client-server-api/#get_matrixclientv3sync) API. See the
        [migration guide](https://matrix.org/docs/guides/migrating-from-client-server-api-v-1#deprecated-endpoints).
      operationId: roomInitialSync
      security:
@ -99,7 +99,7 @@ paths:
                    type: string
                    description: |-
                      A token which correlates to the start of `chunk`. Can be passed to
-                      [`/rooms/<room_id>/messages`](#get_matrixclientr0roomsroomidmessages)
+                      [`/rooms/<room_id>/messages`](#get_matrixclientv3roomsroomidmessages)
                      to retrieve earlier events.

                      If no earlier events are available, this property may be omitted from
@ -108,7 +108,7 @@ paths:
                    type: string
                    description: |-
                      A token which correlates to the end of `chunk`. Can be passed to
-                      [`/rooms/<room_id>/messages`](#get_matrixclientr0roomsroomidmessages)
+                      [`/rooms/<room_id>/messages`](#get_matrixclientv3roomsroomidmessages)
                      to retrieve later events.
                  chunk:
                    type: array
--- a/data/api/client-server/room_send.yaml
+++ b/data/api/client-server/room_send.yaml
@ -19,7 +19,7 @@ host: localhost:8008
 schemes:
  - https
  - http
-basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/client/v3
 consumes:
  - application/json
 produces:
--- a/data/api/client-server/room_state.yaml
+++ b/data/api/client-server/room_state.yaml
@ -19,7 +19,7 @@ host: localhost:8008
 schemes:
  - https
  - http
-basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/client/v3
 consumes:
  - application/json
 produces:
--- a/data/api/client-server/room_upgrades.yaml
+++ b/data/api/client-server/room_upgrades.yaml
@ -19,7 +19,7 @@ host: localhost:8008
 schemes:
  - https
  - http
-basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/client/v3
 consumes:
  - application/json
 produces:
--- a/data/api/client-server/rooms.yaml
+++ b/data/api/client-server/rooms.yaml
@ -19,7 +19,7 @@ host: localhost:8008
 schemes:
  - https
  - http
-basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/client/v3
 consumes:
  - application/json
 produces:
--- a/data/api/client-server/search.yaml
+++ b/data/api/client-server/search.yaml
@ -19,7 +19,7 @@ host: localhost:8008
 schemes:
  - https
  - http
-basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/client/v3
 consumes:
  - application/json
 produces:
--- a/data/api/client-server/sso_login_redirect.yaml
+++ b/data/api/client-server/sso_login_redirect.yaml
@ -19,7 +19,7 @@ host: localhost:8008
 schemes:
  - https
  - http
-basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/client/v3
 paths:
  "/login/sso/redirect":
    get:
--- a/data/api/client-server/sync.yaml
+++ b/data/api/client-server/sync.yaml
@ -18,7 +18,7 @@ info:
 host: localhost:8008
 schemes:
  - https
-basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/client/v3
 consumes:
  - application/json
 produces:
--- a/data/api/client-server/tags.yaml
+++ b/data/api/client-server/tags.yaml
@ -20,7 +20,7 @@ host: localhost:8008
 schemes:
  - https
  - http
-basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/client/v3
 consumes:
  - application/json
 produces:
--- a/data/api/client-server/third_party_lookup.yaml
+++ b/data/api/client-server/third_party_lookup.yaml
@ -19,7 +19,7 @@ host: localhost:8008
 schemes:
  - https
  - http
-basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/client/v3
 consumes:
  - application/json
 produces:
@ -196,7 +196,7 @@ paths:
      security:
        - accessToken: []
      parameters:
-        - in: query 
+        - in: query
          name: userid
          type: string
          description: The Matrix User ID to look up.
--- a/data/api/client-server/third_party_membership.yaml
+++ b/data/api/client-server/third_party_membership.yaml
@ -19,7 +19,7 @@ host: localhost:8008
 schemes:
  - https
  - http
-basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/client/v3
 consumes:
  - application/json
 produces:
@ -36,7 +36,7 @@ paths:
        identifier of the invitee, and instead relies on third party identifiers.
        The homeserver uses an identity server to perform the mapping from
        third party identifier to a Matrix identifier. The other is documented in the*
-        [joining rooms section](/client-server-api/#post_matrixclientr0roomsroomidinvite).
+        [joining rooms section](/client-server-api/#post_matrixclientv3roomsroomidinvite).

        This API invites a user to participate in a particular room.
        They do not start participating in the room until they actually join the
--- a/data/api/client-server/to_device.yaml
+++ b/data/api/client-server/to_device.yaml
@ -20,7 +20,7 @@ host: localhost:8008
 schemes:
  - https
  - http
-basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/client/v3
 consumes:
  - application/json
 produces:
--- a/data/api/client-server/typing.yaml
+++ b/data/api/client-server/typing.yaml
@ -19,7 +19,7 @@ host: localhost:8008
 schemes:
  - https
  - http
-basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/client/v3
 consumes:
  - application/json
 produces:
--- a/data/api/client-server/users.yaml
+++ b/data/api/client-server/users.yaml
@ -19,7 +19,7 @@ host: localhost:8008
 schemes:
  - https
  - http
-basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/client/v3
 consumes:
  - application/json
 produces:
--- a/data/api/client-server/voip.yaml
+++ b/data/api/client-server/voip.yaml
@ -19,7 +19,7 @@ host: localhost:8008
 schemes:
  - https
  - http
-basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/client/v3
 consumes:
  - application/json
 produces:
--- a/data/api/client-server/whoami.yaml
+++ b/data/api/client-server/whoami.yaml
@ -19,7 +19,7 @@ host: localhost:8008
 schemes:
  - https
  - http
-basePath: /_matrix/client/%CLIENT_MAJOR_VERSION%
+basePath: /_matrix/client/v3
 produces:
  - application/json
 securityDefinitions: