diff --git a/docs/openapi.yaml b/docs/openapi.yaml
index 677159c1e7..42db45946d 100644
--- a/docs/openapi.yaml
+++ b/docs/openapi.yaml
@@ -869,7 +869,7 @@ paths:
       summary: Get recent blocks
       deprecated: true
       description: |
-          **NOTE:** This endpoint is deprecated in favor of [Get blocks](#operation/get_blocks).
+          **NOTE:** This endpoint is deprecated in favor of [Get blocks](/api/get-blocks).
 
           Retrieves a list of recently mined blocks
 
@@ -915,7 +915,7 @@ paths:
       deprecated: true
       summary: Get block by hash
       description: |
-        **NOTE:** This endpoint is deprecated in favor of [Get block](#operation/get_block).
+        **NOTE:** This endpoint is deprecated in favor of [Get block](/api/get-block).
         
         Retrieves block details of a specific block for a given chain height. You can use the hash from your latest block ('get_block_list' API) to get your block details.
       tags:
@@ -949,7 +949,7 @@ paths:
       deprecated: true
       summary: Get block by height
       description: |
-        **NOTE:** This endpoint is deprecated in favor of [Get block](#operation/get_block).
+        **NOTE:** This endpoint is deprecated in favor of [Get block](/api/get-block).
 
         Retrieves block details of a specific block at a given block height
       tags:
@@ -983,7 +983,7 @@ paths:
       summary: Get block by burnchain block hash
       deprecated: true
       description: |
-        **NOTE:** This endpoint is deprecated in favor of [Get blocks](#operation/get_blocks).
+        **NOTE:** This endpoint is deprecated in favor of [Get blocks](/api/get-blocks).
 
         Retrieves block details of a specific block for a given burnchain block hash
       tags:
@@ -1018,7 +1018,7 @@ paths:
       summary: Get block by burnchain height
       deprecated: true
       description: |
-        **NOTE:** This endpoint is deprecated in favor of [Get blocks](#operation/get_blocks).
+        **NOTE:** This endpoint is deprecated in favor of [Get blocks](/api/get-blocks).
 
         Retrieves block details of a specific block for a given burn chain height
       tags:
@@ -3009,7 +3009,7 @@ paths:
       operationId: get_transactions_by_block_hash
       summary: Transactions by block hash
       description: |
-        **NOTE:** This endpoint is deprecated in favor of [Get transactions by block](#operation/get_transactions_by_block).
+        **NOTE:** This endpoint is deprecated in favor of [Get transactions by block](/api/get-transactions-by-block).
 
         Retrieves a list of all transactions within a block for a given block hash.
       tags:
@@ -3052,7 +3052,7 @@ paths:
       operationId: get_transactions_by_block_height
       summary: Transactions by block height
       description: |
-        **NOTE:** This endpoint is deprecated in favor of [Get transactions by block](#operation/get_transactions_by_block).
+        **NOTE:** This endpoint is deprecated in favor of [Get transactions by block](/api/get-transactions-by-block).
 
         Retrieves all transactions within a block at a given height
       tags:
@@ -3358,7 +3358,7 @@ paths:
       summary: Fetch fee rate
       deprecated: true
       description: |
-        **NOTE:** This endpoint is deprecated in favor of [Get approximate fees for a given transaction](#operation/post_fee_transaction).
+        **NOTE:** This endpoint is deprecated in favor of [Get approximate fees for a given transaction](/api/get-approximate-fees-for-a-given-transaction).
 
         Retrieves estimated fee rate.
       tags: