diff --git a/api/@ohos.window.d.ts b/api/@ohos.window.d.ts
index 889334c5502d2f19a1c9c469b26adc52bdb35c97..6563946e4c471e23c8309d50aae537954c1f807d 100644
--- a/api/@ohos.window.d.ts
+++ b/api/@ohos.window.d.ts
@@ -7979,6 +7979,21 @@ declare namespace window {
      */
     setWindowShadowEnabled(enable: boolean): Promise<void>;
 
+    /**
+     * Set window container background color in the active and inactive states.
+     *
+     * @param { string } activeColor - window container color in active.
+     * @param { string } inactiveColor - window container color in inactive.
+     * @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API.
+     * @throws { BusinessError } 801 - Capability not supported. Failed to call the API due to limited device capabilities.
+     * @throws { BusinessError } 1300002 - This window state is abnormal.
+     * @throws { BusinessError } 1300004 - Unauthorized operation.
+     * @syscap SystemCapability.Window.SessionManager
+     * @systemapi Hide this for inner system use.
+     * @since 20
+     */
+    setWindowContainerModalColor(activeColor: string, inactiveColor: string): void;
+
     /**
      * Sets the brightness of window.
      *
@@ -10493,16 +10508,11 @@ declare namespace window {
      *
      * @param { string } activeColor - window container color in active.
      * @param { string } inactiveColor - window container color in inactive.
-     * @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API.
-     * @throws { BusinessError } 401 - Parameter error. Possible cause: 1. Mandatory parameters are left unspecified;
-     *                                                                  2. Incorrect parameter types;
      * @throws { BusinessError } 801 - Capability not supported. Failed to call the API due to limited device capabilities.
      * @throws { BusinessError } 1300002 - This window state is abnormal.
      * @throws { BusinessError } 1300004 - Unauthorized operation.
      * @syscap SystemCapability.Window.SessionManager
-     * @systemapi Hide this for inner system use.
-     * @atomicservice
-     * @since 15
+     * @since 20
      */
     setWindowContainerColor(activeColor: string, inactiveColor: string): void;