diff --git a/packages/web-api/src/methods.ts b/packages/web-api/src/methods.ts
index 63c409fba..eb6eb3128 100644
--- a/packages/web-api/src/methods.ts
+++ b/packages/web-api/src/methods.ts
@@ -1884,7 +1884,10 @@ interface FileUpload {
 
 export interface FilesUploadV2Arguments extends FileUploadV2, WebAPICallOptions, TokenOverridable {
   file_uploads?: Omit<FileUploadV2, 'channel_id' | 'channels' | 'initial_comment' | 'thread_ts'>[];
-  request_file_info?: boolean; // since v7, this flag is no longer used
+  /**
+   * @deprecated Since v7, this flag is no longer used. You can safely remove it from your code.
+   */
+  request_file_info?: boolean;
 }
 
 export type FileUploadV2 = FileUpload & {