diff --git a/api/@ohos.window.d.ts b/api/@ohos.window.d.ts
index f1a98dcce6..05dc850472 100644
--- a/api/@ohos.window.d.ts
+++ b/api/@ohos.window.d.ts
@@ -3072,6 +3072,17 @@ declare namespace window {
    * @systemapi Hide this for inner system use.
    * @since 12
    */
+  /**
+   * Get info of visible windows.
+   *
+   * @permission ohos.permission.VISIBLE_WINDOW_INFO
+   * @returns { Promise<Array<WindowInfo>> } - Promise that returns windowInfo list.
+   * @throws { BusinessError } 201 - Permission verification failed. The application does not have the permission required to call the API.
+   * @throws { BusinessError } 801 - Capability not supported. Function getVisibleWindowInfo can not work correctly due to limited device capabilities.
+   * @throws { BusinessError } 1300003 - This window manager service works abnormally.
+   * @syscap SystemCapability.Window.SessionManager
+   * @since 18
+   */
   function getVisibleWindowInfo(): Promise<Array<WindowInfo>>;
 
   /**