diff --git a/api/client-server/administrative_contact.yaml b/api/client-server/administrative_contact.yaml
index 7c0f1329..003b9f82 100644
--- a/api/client-server/administrative_contact.yaml
+++ b/api/client-server/administrative_contact.yaml
@@ -129,10 +129,6 @@ paths:
         validation tokens when adding an email address to an account. This API's
         parameters and response is identical to that of the HS API
         |/register/email/requestToken|_ endpoint.
-
-        .. |/register/email/requestToken| replace:: ``/register/email/requestToken``
-
-        .. _/register/email/requestToken: #post-matrix-client-%CLIENT_MAJOR_VERSION%-register-email-requesttoken
       responses:
         200:
           description: An email was sent to the given address
diff --git a/api/client-server/registration.yaml b/api/client-server/registration.yaml
index 7c675e5f..0e2bc21b 100644
--- a/api/client-server/registration.yaml
+++ b/api/client-server/registration.yaml
@@ -136,8 +136,6 @@ paths:
     post:
       summary: Requests a validation token be sent to the given email address for the purpose of registering an account
       description: |-
-        .. _register-email-requestToken-endpoint:
-
         Proxies the identity server API ``validate/email/requestToken``, but
         first checks that the given email address is not already associated
         with an account on this Home Server. Note that, for consistency,
@@ -253,11 +251,15 @@ paths:
         on this Home Server. This API should be used to request
         validation tokens when authenticating for the
         `account/password` endpoint. This API's parameters and response are
-        identical to that of `/register/email/requestToken` except that
+        identical to that of the HS API |/register/email/requestToken|_ 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
         email to the given address prompting the user to create an account.
         `M_THREEPID_IN_USE` may not be returned.
+
+        .. |/register/email/requestToken| replace:: ``/register/email/requestToken``
+
+        .. _/register/email/requestToken: #post-matrix-client-%CLIENT_MAJOR_VERSION%-register-email-requesttoken
       responses:
         200:
           description: An email was sent to the given address