appwrite · abnegate · Nov 3, 2025 · Nov 3, 2025 · Nov 3, 2025
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,10 @@
 # Change Log
 
+## 12.3.0
+
+* Add `total` parameter to list queries allowing skipping counting rows in a table for improved performance
+* Add `Operator` class for atomic modification of rows via update, bulk update, upsert, and bulk upsert operations
+
 ## 12.2.1
 
 * Add transaction support for Databases and TablesDB

diff --git a/README.md b/README.md
@@ -39,7 +39,7 @@ repositories {
 Next, add the dependency to your project's `build.gradle(.kts)` file:
 
 ```groovy
-implementation("io.appwrite:sdk-for-kotlin:12.2.1")
+implementation("io.appwrite:sdk-for-kotlin:12.3.0")
 ```
 
 ### Maven
@@ -50,7 +50,7 @@ Add this to your project's `pom.xml` file:
     <dependency>
         <groupId>io.appwrite</groupId>
         <artifactId>sdk-for-kotlin</artifactId>
-        <version>12.2.1</version>
+        <version>12.3.0</version>
     </dependency>
 </dependencies>
 ```

diff --git a/docs/examples/java/account/list-identities.md b/docs/examples/java/account/list-identities.md
@@ -11,6 +11,7 @@ Account account = new Account(client);
 
 account.listIdentities(
     listOf(), // queries (optional)
+    false, // total (optional)
     new CoroutineCallback<>((result, error) -> {
         if (error != null) {
             error.printStackTrace();

diff --git a/docs/examples/java/account/list-logs.md b/docs/examples/java/account/list-logs.md
@@ -11,6 +11,7 @@ Account account = new Account(client);
 
 account.listLogs(
     listOf(), // queries (optional)
+    false, // total (optional)
     new CoroutineCallback<>((result, error) -> {
         if (error != null) {
             error.printStackTrace();

diff --git a/docs/examples/java/databases/create-collection.md b/docs/examples/java/databases/create-collection.md
@@ -1,6 +1,8 @@
 import io.appwrite.Client;
 import io.appwrite.coroutines.CoroutineCallback;
 import io.appwrite.services.Databases;
+import io.appwrite.Permission;
+import io.appwrite.Role;
 
 Client client = new Client()
     .setEndpoint("https://<REGION>.cloud.appwrite.io/v1") // Your API Endpoint
@@ -13,7 +15,7 @@ databases.createCollection(
     "<DATABASE_ID>", // databaseId
     "<COLLECTION_ID>", // collectionId
     "<NAME>", // name
-    listOf("read("any")"), // permissions (optional)
+    listOf(Permission.read(Role.any())), // permissions (optional)
     false, // documentSecurity (optional)
     false, // enabled (optional)
     new CoroutineCallback<>((result, error) -> {

diff --git a/docs/examples/java/databases/create-document.md b/docs/examples/java/databases/create-document.md
@@ -1,6 +1,8 @@
 import io.appwrite.Client;
 import io.appwrite.coroutines.CoroutineCallback;
 import io.appwrite.services.Databases;
+import io.appwrite.Permission;
+import io.appwrite.Role;
 
 Client client = new Client()
     .setEndpoint("https://<REGION>.cloud.appwrite.io/v1") // Your API Endpoint
@@ -20,7 +22,7 @@ databases.createDocument(
         "age" to 30,
         "isAdmin" to false
     ), // data
-    listOf("read("any")"), // permissions (optional)
+    listOf(Permission.read(Role.any())), // permissions (optional)
     "<TRANSACTION_ID>", // transactionId (optional)
     new CoroutineCallback<>((result, error) -> {
         if (error != null) {

diff --git a/docs/examples/java/databases/list-attributes.md b/docs/examples/java/databases/list-attributes.md
@@ -13,6 +13,7 @@ databases.listAttributes(
     "<DATABASE_ID>", // databaseId
     "<COLLECTION_ID>", // collectionId
     listOf(), // queries (optional)
+    false, // total (optional)
     new CoroutineCallback<>((result, error) -> {
         if (error != null) {
             error.printStackTrace();

diff --git a/docs/examples/java/databases/list-collections.md b/docs/examples/java/databases/list-collections.md
@@ -13,6 +13,7 @@ databases.listCollections(
     "<DATABASE_ID>", // databaseId
     listOf(), // queries (optional)
     "<SEARCH>", // search (optional)
+    false, // total (optional)
     new CoroutineCallback<>((result, error) -> {
         if (error != null) {
             error.printStackTrace();

diff --git a/docs/examples/java/databases/list-documents.md b/docs/examples/java/databases/list-documents.md
@@ -14,6 +14,7 @@ databases.listDocuments(
     "<COLLECTION_ID>", // collectionId
     listOf(), // queries (optional)
     "<TRANSACTION_ID>", // transactionId (optional)
+    false, // total (optional)
     new CoroutineCallback<>((result, error) -> {
         if (error != null) {
             error.printStackTrace();

diff --git a/docs/examples/java/databases/list-indexes.md b/docs/examples/java/databases/list-indexes.md
@@ -13,6 +13,7 @@ databases.listIndexes(
     "<DATABASE_ID>", // databaseId
     "<COLLECTION_ID>", // collectionId
     listOf(), // queries (optional)
+    false, // total (optional)
     new CoroutineCallback<>((result, error) -> {
         if (error != null) {
             error.printStackTrace();

diff --git a/docs/examples/java/databases/list.md b/docs/examples/java/databases/list.md
@@ -12,6 +12,7 @@ Databases databases = new Databases(client);
 databases.list(
     listOf(), // queries (optional)
     "<SEARCH>", // search (optional)
+    false, // total (optional)
     new CoroutineCallback<>((result, error) -> {
         if (error != null) {
             error.printStackTrace();

diff --git a/docs/examples/java/databases/update-collection.md b/docs/examples/java/databases/update-collection.md
@@ -1,6 +1,8 @@
 import io.appwrite.Client;
 import io.appwrite.coroutines.CoroutineCallback;
 import io.appwrite.services.Databases;
+import io.appwrite.Permission;
+import io.appwrite.Role;
 
 Client client = new Client()
     .setEndpoint("https://<REGION>.cloud.appwrite.io/v1") // Your API Endpoint
@@ -13,7 +15,7 @@ databases.updateCollection(
     "<DATABASE_ID>", // databaseId
     "<COLLECTION_ID>", // collectionId
     "<NAME>", // name
-    listOf("read("any")"), // permissions (optional)
+    listOf(Permission.read(Role.any())), // permissions (optional)
     false, // documentSecurity (optional)
     false, // enabled (optional)
     new CoroutineCallback<>((result, error) -> {

diff --git a/docs/examples/java/databases/update-document.md b/docs/examples/java/databases/update-document.md
@@ -1,6 +1,8 @@
 import io.appwrite.Client;
 import io.appwrite.coroutines.CoroutineCallback;
 import io.appwrite.services.Databases;
+import io.appwrite.Permission;
+import io.appwrite.Role;
 
 Client client = new Client()
     .setEndpoint("https://<REGION>.cloud.appwrite.io/v1") // Your API Endpoint
@@ -14,7 +16,7 @@ databases.updateDocument(
     "<COLLECTION_ID>", // collectionId
     "<DOCUMENT_ID>", // documentId
     mapOf( "a" to "b" ), // data (optional)
-    listOf("read("any")"), // permissions (optional)
+    listOf(Permission.read(Role.any())), // permissions (optional)
     "<TRANSACTION_ID>", // transactionId (optional)
     new CoroutineCallback<>((result, error) -> {
         if (error != null) {

diff --git a/docs/examples/java/databases/upsert-document.md b/docs/examples/java/databases/upsert-document.md
@@ -1,6 +1,8 @@
 import io.appwrite.Client;
 import io.appwrite.coroutines.CoroutineCallback;
 import io.appwrite.services.Databases;
+import io.appwrite.Permission;
+import io.appwrite.Role;
 
 Client client = new Client()
     .setEndpoint("https://<REGION>.cloud.appwrite.io/v1") // Your API Endpoint
@@ -14,7 +16,7 @@ databases.upsertDocument(
     "<COLLECTION_ID>", // collectionId
     "<DOCUMENT_ID>", // documentId
     mapOf( "a" to "b" ), // data
-    listOf("read("any")"), // permissions (optional)
+    listOf(Permission.read(Role.any())), // permissions (optional)
     "<TRANSACTION_ID>", // transactionId (optional)
     new CoroutineCallback<>((result, error) -> {
         if (error != null) {

diff --git a/docs/examples/java/functions/list-deployments.md b/docs/examples/java/functions/list-deployments.md
@@ -13,6 +13,7 @@ functions.listDeployments(
     "<FUNCTION_ID>", // functionId
     listOf(), // queries (optional)
     "<SEARCH>", // search (optional)
+    false, // total (optional)
     new CoroutineCallback<>((result, error) -> {
         if (error != null) {
             error.printStackTrace();

diff --git a/docs/examples/java/functions/list-executions.md b/docs/examples/java/functions/list-executions.md
@@ -12,6 +12,7 @@ Functions functions = new Functions(client);
 functions.listExecutions(
     "<FUNCTION_ID>", // functionId
     listOf(), // queries (optional)
+    false, // total (optional)
     new CoroutineCallback<>((result, error) -> {
         if (error != null) {
             error.printStackTrace();

diff --git a/docs/examples/java/functions/list.md b/docs/examples/java/functions/list.md
@@ -12,6 +12,7 @@ Functions functions = new Functions(client);
 functions.list(
     listOf(), // queries (optional)
     "<SEARCH>", // search (optional)
+    false, // total (optional)
     new CoroutineCallback<>((result, error) -> {
         if (error != null) {
             error.printStackTrace();

diff --git a/docs/examples/java/messaging/create-resend-provider.md b/docs/examples/java/messaging/create-resend-provider.md
@@ -0,0 +1,30 @@
+import io.appwrite.Client;
+import io.appwrite.coroutines.CoroutineCallback;
+import io.appwrite.services.Messaging;
+
+Client client = new Client()
+    .setEndpoint("https://<REGION>.cloud.appwrite.io/v1") // Your API Endpoint
+    .setProject("<YOUR_PROJECT_ID>") // Your project ID
+    .setKey("<YOUR_API_KEY>"); // Your secret API key
+
+Messaging messaging = new Messaging(client);
+
+messaging.createResendProvider(
+    "<PROVIDER_ID>", // providerId
+    "<NAME>", // name
+    "<API_KEY>", // apiKey (optional)
+    "<FROM_NAME>", // fromName (optional)
+    "[email protected]", // fromEmail (optional)
+    "<REPLY_TO_NAME>", // replyToName (optional)
+    "[email protected]", // replyToEmail (optional)
+    false, // enabled (optional)
+    new CoroutineCallback<>((result, error) -> {
+        if (error != null) {
+            error.printStackTrace();
+            return;
+        }
+
+        System.out.println(result);
+    })
+);
+
diff --git a/docs/examples/java/messaging/list-message-logs.md b/docs/examples/java/messaging/list-message-logs.md
@@ -12,6 +12,7 @@ Messaging messaging = new Messaging(client);
 messaging.listMessageLogs(
     "<MESSAGE_ID>", // messageId
     listOf(), // queries (optional)
+    false, // total (optional)
     new CoroutineCallback<>((result, error) -> {
         if (error != null) {
             error.printStackTrace();

diff --git a/docs/examples/java/messaging/list-messages.md b/docs/examples/java/messaging/list-messages.md
@@ -12,6 +12,7 @@ Messaging messaging = new Messaging(client);
 messaging.listMessages(
     listOf(), // queries (optional)
     "<SEARCH>", // search (optional)
+    false, // total (optional)
     new CoroutineCallback<>((result, error) -> {
         if (error != null) {
             error.printStackTrace();

diff --git a/docs/examples/java/messaging/list-provider-logs.md b/docs/examples/java/messaging/list-provider-logs.md
@@ -12,6 +12,7 @@ Messaging messaging = new Messaging(client);
 messaging.listProviderLogs(
     "<PROVIDER_ID>", // providerId
     listOf(), // queries (optional)
+    false, // total (optional)
     new CoroutineCallback<>((result, error) -> {
         if (error != null) {
             error.printStackTrace();

diff --git a/docs/examples/java/messaging/list-providers.md b/docs/examples/java/messaging/list-providers.md
@@ -12,6 +12,7 @@ Messaging messaging = new Messaging(client);
 messaging.listProviders(
     listOf(), // queries (optional)
     "<SEARCH>", // search (optional)
+    false, // total (optional)
     new CoroutineCallback<>((result, error) -> {
         if (error != null) {
             error.printStackTrace();

diff --git a/docs/examples/java/messaging/list-subscriber-logs.md b/docs/examples/java/messaging/list-subscriber-logs.md
@@ -12,6 +12,7 @@ Messaging messaging = new Messaging(client);
 messaging.listSubscriberLogs(
     "<SUBSCRIBER_ID>", // subscriberId
     listOf(), // queries (optional)
+    false, // total (optional)
     new CoroutineCallback<>((result, error) -> {
         if (error != null) {
             error.printStackTrace();

diff --git a/docs/examples/java/messaging/list-subscribers.md b/docs/examples/java/messaging/list-subscribers.md
@@ -13,6 +13,7 @@ messaging.listSubscribers(
     "<TOPIC_ID>", // topicId
     listOf(), // queries (optional)
     "<SEARCH>", // search (optional)
+    false, // total (optional)
     new CoroutineCallback<>((result, error) -> {
         if (error != null) {
             error.printStackTrace();

diff --git a/docs/examples/java/messaging/list-targets.md b/docs/examples/java/messaging/list-targets.md
@@ -12,6 +12,7 @@ Messaging messaging = new Messaging(client);
 messaging.listTargets(
     "<MESSAGE_ID>", // messageId
     listOf(), // queries (optional)
+    false, // total (optional)
     new CoroutineCallback<>((result, error) -> {
         if (error != null) {
             error.printStackTrace();

diff --git a/docs/examples/java/messaging/list-topic-logs.md b/docs/examples/java/messaging/list-topic-logs.md
@@ -12,6 +12,7 @@ Messaging messaging = new Messaging(client);
 messaging.listTopicLogs(
     "<TOPIC_ID>", // topicId
     listOf(), // queries (optional)
+    false, // total (optional)
     new CoroutineCallback<>((result, error) -> {
         if (error != null) {
             error.printStackTrace();

diff --git a/docs/examples/java/messaging/list-topics.md b/docs/examples/java/messaging/list-topics.md
@@ -12,6 +12,7 @@ Messaging messaging = new Messaging(client);
 messaging.listTopics(
     listOf(), // queries (optional)
     "<SEARCH>", // search (optional)
+    false, // total (optional)
     new CoroutineCallback<>((result, error) -> {
         if (error != null) {
             error.printStackTrace();

diff --git a/docs/examples/java/messaging/update-resend-provider.md b/docs/examples/java/messaging/update-resend-provider.md
@@ -0,0 +1,30 @@
+import io.appwrite.Client;
+import io.appwrite.coroutines.CoroutineCallback;
+import io.appwrite.services.Messaging;
+
+Client client = new Client()
+    .setEndpoint("https://<REGION>.cloud.appwrite.io/v1") // Your API Endpoint
+    .setProject("<YOUR_PROJECT_ID>") // Your project ID
+    .setKey("<YOUR_API_KEY>"); // Your secret API key
+
+Messaging messaging = new Messaging(client);
+
+messaging.updateResendProvider(
+    "<PROVIDER_ID>", // providerId
+    "<NAME>", // name (optional)
+    false, // enabled (optional)
+    "<API_KEY>", // apiKey (optional)
+    "<FROM_NAME>", // fromName (optional)
+    "[email protected]", // fromEmail (optional)
+    "<REPLY_TO_NAME>", // replyToName (optional)
+    "<REPLY_TO_EMAIL>", // replyToEmail (optional)
+    new CoroutineCallback<>((result, error) -> {
+        if (error != null) {
+            error.printStackTrace();
+            return;
+        }
+
+        System.out.println(result);
+    })
+);
+
diff --git a/docs/examples/java/sites/list-deployments.md b/docs/examples/java/sites/list-deployments.md
@@ -13,6 +13,7 @@ sites.listDeployments(
     "<SITE_ID>", // siteId
     listOf(), // queries (optional)
     "<SEARCH>", // search (optional)
+    false, // total (optional)
     new CoroutineCallback<>((result, error) -> {
         if (error != null) {
             error.printStackTrace();

diff --git a/docs/examples/java/sites/list-logs.md b/docs/examples/java/sites/list-logs.md
@@ -12,6 +12,7 @@ Sites sites = new Sites(client);
 sites.listLogs(
     "<SITE_ID>", // siteId
     listOf(), // queries (optional)
+    false, // total (optional)
     new CoroutineCallback<>((result, error) -> {
         if (error != null) {
             error.printStackTrace();

diff --git a/docs/examples/java/sites/list.md b/docs/examples/java/sites/list.md
@@ -12,6 +12,7 @@ Sites sites = new Sites(client);
 sites.list(
     listOf(), // queries (optional)
     "<SEARCH>", // search (optional)
+    false, // total (optional)
     new CoroutineCallback<>((result, error) -> {
         if (error != null) {
             error.printStackTrace();

diff --git a/docs/examples/java/storage/create-bucket.md b/docs/examples/java/storage/create-bucket.md
@@ -1,6 +1,8 @@
 import io.appwrite.Client;
 import io.appwrite.coroutines.CoroutineCallback;
 import io.appwrite.services.Storage;
+import io.appwrite.Permission;
+import io.appwrite.Role;
 
 Client client = new Client()
     .setEndpoint("https://<REGION>.cloud.appwrite.io/v1") // Your API Endpoint
@@ -12,7 +14,7 @@ Storage storage = new Storage(client);
 storage.createBucket(
     "<BUCKET_ID>", // bucketId
     "<NAME>", // name
-    listOf("read("any")"), // permissions (optional)
+    listOf(Permission.read(Role.any())), // permissions (optional)
     false, // fileSecurity (optional)
     false, // enabled (optional)
     1, // maximumFileSize (optional)

diff --git a/docs/examples/java/storage/create-file.md b/docs/examples/java/storage/create-file.md
@@ -2,6 +2,8 @@ import io.appwrite.Client;
 import io.appwrite.coroutines.CoroutineCallback;
 import io.appwrite.models.InputFile;
 import io.appwrite.services.Storage;
+import io.appwrite.Permission;
+import io.appwrite.Role;
 
 Client client = new Client()
     .setEndpoint("https://<REGION>.cloud.appwrite.io/v1") // Your API Endpoint
@@ -14,7 +16,7 @@ storage.createFile(
     "<BUCKET_ID>", // bucketId
     "<FILE_ID>", // fileId
     InputFile.fromPath("file.png"), // file
-    listOf("read("any")"), // permissions (optional)
+    listOf(Permission.read(Role.any())), // permissions (optional)
     new CoroutineCallback<>((result, error) -> {
         if (error != null) {
             error.printStackTrace();