diff --git a/swh/web/api/views/vault.py b/swh/web/api/views/vault.py
--- a/swh/web/api/views/vault.py
+++ b/swh/web/api/views/vault.py
@@ -205,7 +205,7 @@
     """
     .. http:get:: /api/1/vault/directory/(dir_id)/raw/
 
-        This endpoint was replaced by :http:get:`/api/1/vault/flat/raw/`
+        This endpoint was replaced by :http:get:`/api/1/vault/flat/(swhid)/raw/`
     """
     _, obj_id = query.parse_hash_with_algorithms_or_throws(
         dir_id, ["sha1"], "Only sha1_git is supported."
@@ -308,7 +308,7 @@
     """
     .. http:get:: /api/1/vault/revision/(rev_id)/gitfast/
 
-        This endpoint was replaced by :http:get:`/api/1/vault/gitfast/`
+        This endpoint was replaced by :http:get:`/api/1/vault/gitfast/(swhid)/`
     """
     _, obj_id = query.parse_hash_with_algorithms_or_throws(
         rev_id, ["sha1"], "Only sha1_git is supported."
@@ -369,7 +369,7 @@
     """
     .. http:get:: /api/1/vault/revision/(rev_id)/gitfast/raw/
 
-        This endpoint was replaced by :http:get:`/api/1/vault/gitfast/raw/`
+        This endpoint was replaced by :http:get:`/api/1/vault/gitfast/(swhid)/raw/`
     """
     rev_gitfast_raw_url = reverse(
         "api-1-vault-fetch-gitfast", url_args={"swhid": f"swh:1:rev:{rev_id}"}