diff --git a/configuration/app-backend/client-side-integration.mdx b/configuration/app-backend/client-side-integration.mdx
index d556fb42..4ab4b130 100644
--- a/configuration/app-backend/client-side-integration.mdx
+++ b/configuration/app-backend/client-side-integration.mdx
@@ -62,7 +62,7 @@ The default throttle interval varies by SDK:
 | SDK | Default | Option Name |
 | --- | --- | --- |
 | JavaScript / React Native / Node / Capacitor / Tauri | 1,000 ms | `crudUploadThrottleMs` |
-| Kotlin | 1,000 ms | `crudThrottleMs` |
+| Kotlin | 1 second | `crudThrottle` (`Duration`) |
 | Swift | 1 second | `crudThrottle` (seconds) |
 | .NET | 1,000 ms | `CrudUploadThrottleMs` |
 | Dart / Flutter | 10 ms | `crudThrottleTime` |
@@ -85,7 +85,11 @@ db.connect(
 ```
 
 ```kotlin Kotlin
-database.connect(connector, crudThrottleMs = 500L)
+// Requires Kotlin SDK 1.16.0 or later
+database.connect(
+  connector,
+  options = SyncOptions(crudThrottle = 500.milliseconds),
+)
 ```
 
 ```swift Swift
diff --git a/maintenance-ops/monitoring-and-alerting.mdx b/maintenance-ops/monitoring-and-alerting.mdx
index 091b19f3..8c490248 100644
--- a/maintenance-ops/monitoring-and-alerting.mdx
+++ b/maintenance-ops/monitoring-and-alerting.mdx
@@ -320,6 +320,7 @@ You can specify application metadata when calling `PowerSyncDatabase.connect()`.
     ```kotlin
     import com.powersync.DatabaseDriverFactory
     import com.powersync.PowerSyncDatabase
+    import com.powersync.sync.SyncOptions
     
     // Android
     val driverFactory = DatabaseDriverFactory(this)
@@ -333,11 +334,15 @@ You can specify application metadata when calling `PowerSyncDatabase.connect()`.
     })
     
     // Set custom metadata when connecting
+    // Requires Kotlin SDK 1.16.0 or later.
+    // On earlier versions, pass appMetadata directly to connect().
     powerSync.connect(
       connector = MyConnector(),
-      appMetadata = mapOf(
-        "app_version" to "1.2.3",
-        "feature_flag" to "new_sync_flow"
+      options = SyncOptions(
+        appMetadata = mapOf(
+          "app_version" to "1.2.3",
+          "feature_flag" to "new_sync_flow"
+        )
       )
     )
     ```
diff --git a/sync/streams/client-usage.mdx b/sync/streams/client-usage.mdx
index cc637a07..89c15587 100644
--- a/sync/streams/client-usage.mdx
+++ b/sync/streams/client-usage.mdx
@@ -556,9 +556,12 @@ Set connection parameters when connecting:
   </Tab>
   <Tab title="Kotlin">
     ```kotlin
+    // Requires Kotlin SDK 1.16.0 or later
     database.connect(
       connector,
-      params = mapOf("environment" to JsonParam.String("production"))
+      options = SyncOptions(
+        params = mapOf("environment" to JsonParam.String("production"))
+      )
     )
     ```
   </Tab>