diff --git a/www/api-reference/specs/admin/components/schemas/AdminDeleteUploadsReq.yaml b/www/api-reference/specs/admin/components/schemas/AdminDeleteUploadsReq.yaml
index 0a967b0845..74a8b059c7 100644
--- a/www/api-reference/specs/admin/components/schemas/AdminDeleteUploadsReq.yaml
+++ b/www/api-reference/specs/admin/components/schemas/AdminDeleteUploadsReq.yaml
@@ -3,5 +3,7 @@ required:
   - file_key
 properties:
   file_key:
-    description: key of the file to delete
+    description: >-
+      key of the file to delete. This is obtained when you first uploaded the
+      file, or by the file service if you used it directly.
     type: string
diff --git a/www/api-reference/specs/admin/components/schemas/AdminPostUploadsDownloadUrlReq.yaml b/www/api-reference/specs/admin/components/schemas/AdminPostUploadsDownloadUrlReq.yaml
index c3b01ef725..1d6bb38902 100644
--- a/www/api-reference/specs/admin/components/schemas/AdminPostUploadsDownloadUrlReq.yaml
+++ b/www/api-reference/specs/admin/components/schemas/AdminPostUploadsDownloadUrlReq.yaml
@@ -3,5 +3,7 @@ required:
   - file_key
 properties:
   file_key:
-    description: key of the file to obtain the download link for
+    description: >-
+      key of the file to obtain the download link for. This is obtained when you
+      first uploaded the file, or by the file service if you used it directly.
     type: string
diff --git a/www/api-reference/specs/admin/components/schemas/AdminUploadsRes.yaml b/www/api-reference/specs/admin/components/schemas/AdminUploadsRes.yaml
index ca464c96b2..447c898afe 100644
--- a/www/api-reference/specs/admin/components/schemas/AdminUploadsRes.yaml
+++ b/www/api-reference/specs/admin/components/schemas/AdminUploadsRes.yaml
@@ -9,8 +9,14 @@ properties:
       type: object
       required:
         - url
+        - key
       properties:
         url:
           description: The URL of the uploaded file.
           type: string
           format: uri
+        key:
+          description: >-
+            The key of the file that is identifiable by the file service. It can
+            be used later to retrieve or manipulate the file.
+          type: string