diff --git a/docs/api/apiv3/paths/storage.yml b/docs/api/apiv3/paths/storage.yml
index 16aea686bc..d5f1f3734b 100644
--- a/docs/api/apiv3/paths/storage.yml
+++ b/docs/api/apiv3/paths/storage.yml
@@ -6,7 +6,8 @@ get:
   tags:
     - File links
   description: |-
-    Gets a storage resource.
+    Gets a storage resource. As a side effect, a live connection to the storages origin is established to retrieve
+    connection state data.
   parameters:
     - name: id
       description: Storage id
diff --git a/docs/api/apiv3/paths/work_package_file_links.yml b/docs/api/apiv3/paths/work_package_file_links.yml
index fafb26ca08..a49e2bbbd1 100644
--- a/docs/api/apiv3/paths/work_package_file_links.yml
+++ b/docs/api/apiv3/paths/work_package_file_links.yml
@@ -118,6 +118,9 @@ get:
     - File links
   description: |-
     Gets all file links of a work package.
+    
+    As a side effect, for every file link a request is sent to the storage's origin to fetch live data and patch
+    the file link's data before returning, as well as retrieving permissions of the user on this origin file. 
   parameters:
     - name: id
       description: Work package id