diff --git a/zaas-service/src/main/resources/zaas-api-doc.json b/zaas-service/src/main/resources/zaas-api-doc.json
index 0e94c71c0f..4112e2e8e6 100644
--- a/zaas-service/src/main/resources/zaas-api-doc.json
+++ b/zaas-service/src/main/resources/zaas-api-doc.json
@@ -26,7 +26,7 @@
                             }
                         }
                     },
-                    "description": "Specifies the user credentials to be authenticated."
+                    "description": "Specifies the user credentials to be authenticated. If newPassword is provided and the password is valid, the password is changed to newPassword"
                 },
                 "security": [
                     {
@@ -260,6 +260,9 @@
                     },
                     "password": {
                         "type": "string"
+                    },
+                    "newPassword": {
+                        "type": "string"
                     }
                 },
                 "required": ["username", "password"],