diff --git a/sdk/cosmos/azure-cosmos/src/main/java/com/azure/cosmos/GatewayConnectionConfig.java b/sdk/cosmos/azure-cosmos/src/main/java/com/azure/cosmos/GatewayConnectionConfig.java
index 7be90be45a44..4dcf8092f088 100644
--- a/sdk/cosmos/azure-cosmos/src/main/java/com/azure/cosmos/GatewayConnectionConfig.java
+++ b/sdk/cosmos/azure-cosmos/src/main/java/com/azure/cosmos/GatewayConnectionConfig.java
@@ -113,10 +113,11 @@ public ProxyOptions getProxy() {
     }
 
     /**
-     * This will create the InetSocketAddress for proxy server,
-     * all the requests to cosmoDB will route from this address.
+     * Sets the proxy options.
      *
-     * @param proxy The proxy server.
+     * Currently only support Http proxy type with just the routing address. Username and password will be ignored.
+     *
+     * @param proxy The proxy options.
      * @return the {@link GatewayConnectionConfig}.
      */
 
diff --git a/sdk/cosmos/azure-cosmos/src/main/java/com/azure/cosmos/implementation/ConnectionPolicy.java b/sdk/cosmos/azure-cosmos/src/main/java/com/azure/cosmos/implementation/ConnectionPolicy.java
index 097943296d7b..8cd10ff316af 100644
--- a/sdk/cosmos/azure-cosmos/src/main/java/com/azure/cosmos/implementation/ConnectionPolicy.java
+++ b/sdk/cosmos/azure-cosmos/src/main/java/com/azure/cosmos/implementation/ConnectionPolicy.java
@@ -359,10 +359,11 @@ public ProxyOptions getProxy() {
     }
 
     /**
-     * This will create the InetSocketAddress for proxy server,
-     * all the requests to cosmoDB will route from this address.
+     * Sets the proxy options.
      *
-     * @param proxy The proxy server.
+     * Currently only support Http proxy type with just the routing address. Username and password will be ignored.
+     *
+     * @param proxy The proxy options.
      * @return the ConnectionPolicy.
      */