appwrite · abnegate · Nov 3, 2025 · Nov 3, 2025 · Nov 3, 2025
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,11 @@
 # Change Log
 
+## 19.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
+* Add `create_resend_provider` and `update_resend_provider` methods to `Messaging` service
+
 ## 19.2.1
 
 * Add transaction support for Databases and TablesDB

diff --git a/appwrite.gemspec b/appwrite.gemspec
@@ -1,7 +1,7 @@
 Gem::Specification.new do |spec|
 
   spec.name = 'appwrite'
-  spec.version = '19.2.1'
+  spec.version = '19.3.0'
   spec.license = 'BSD-3-Clause'
   spec.summary = 'Appwrite is an open-source self-hosted backend server that abstract and simplify complex and repetitive development tasks behind a very simple REST API'
   spec.author = 'Appwrite Team'

diff --git a/docs/examples/account/list-identities.md b/docs/examples/account/list-identities.md
@@ -10,5 +10,6 @@ client = Client.new
 account = Account.new(client)
 
 result = account.list_identities(
-    queries: [] # optional
+    queries: [], # optional
+    total: false # optional
 )
diff --git a/docs/examples/account/list-logs.md b/docs/examples/account/list-logs.md
@@ -10,5 +10,6 @@ client = Client.new
 account = Account.new(client)
 
 result = account.list_logs(
-    queries: [] # optional
+    queries: [], # optional
+    total: false # optional
 )
diff --git a/docs/examples/databases/create-collection.md b/docs/examples/databases/create-collection.md
@@ -1,6 +1,8 @@
 require 'appwrite'
 
 include Appwrite
+include Appwrite::Permission
+include Appwrite::Role
 
 client = Client.new
     .set_endpoint('https://<REGION>.cloud.appwrite.io/v1') # Your API Endpoint
@@ -13,7 +15,7 @@ result = databases.create_collection(
     database_id: '<DATABASE_ID>',
     collection_id: '<COLLECTION_ID>',
     name: '<NAME>',
-    permissions: ["read("any")"], # optional
+    permissions: [Permission.read(Role.any())], # optional
     document_security: false, # optional
     enabled: false # optional
 )
diff --git a/docs/examples/databases/create-document.md b/docs/examples/databases/create-document.md
@@ -1,6 +1,8 @@
 require 'appwrite'
 
 include Appwrite
+include Appwrite::Permission
+include Appwrite::Role
 
 client = Client.new
     .set_endpoint('https://<REGION>.cloud.appwrite.io/v1') # Your API Endpoint
@@ -20,6 +22,6 @@ result = databases.create_document(
         "age" => 30,
         "isAdmin" => false
     },
-    permissions: ["read("any")"], # optional
+    permissions: [Permission.read(Role.any())], # optional
     transaction_id: '<TRANSACTION_ID>' # optional
 )
diff --git a/docs/examples/databases/list-attributes.md b/docs/examples/databases/list-attributes.md
@@ -12,5 +12,6 @@ databases = Databases.new(client)
 result = databases.list_attributes(
     database_id: '<DATABASE_ID>',
     collection_id: '<COLLECTION_ID>',
-    queries: [] # optional
+    queries: [], # optional
+    total: false # optional
 )
diff --git a/docs/examples/databases/list-collections.md b/docs/examples/databases/list-collections.md
@@ -12,5 +12,6 @@ databases = Databases.new(client)
 result = databases.list_collections(
     database_id: '<DATABASE_ID>',
     queries: [], # optional
-    search: '<SEARCH>' # optional
+    search: '<SEARCH>', # optional
+    total: false # optional
 )
diff --git a/docs/examples/databases/list-documents.md b/docs/examples/databases/list-documents.md
@@ -13,5 +13,6 @@ result = databases.list_documents(
     database_id: '<DATABASE_ID>',
     collection_id: '<COLLECTION_ID>',
     queries: [], # optional
-    transaction_id: '<TRANSACTION_ID>' # optional
+    transaction_id: '<TRANSACTION_ID>', # optional
+    total: false # optional
 )
diff --git a/docs/examples/databases/list-indexes.md b/docs/examples/databases/list-indexes.md
@@ -12,5 +12,6 @@ databases = Databases.new(client)
 result = databases.list_indexes(
     database_id: '<DATABASE_ID>',
     collection_id: '<COLLECTION_ID>',
-    queries: [] # optional
+    queries: [], # optional
+    total: false # optional
 )
diff --git a/docs/examples/databases/list.md b/docs/examples/databases/list.md
@@ -11,5 +11,6 @@ databases = Databases.new(client)
 
 result = databases.list(
     queries: [], # optional
-    search: '<SEARCH>' # optional
+    search: '<SEARCH>', # optional
+    total: false # optional
 )
diff --git a/docs/examples/databases/update-collection.md b/docs/examples/databases/update-collection.md
@@ -1,6 +1,8 @@
 require 'appwrite'
 
 include Appwrite
+include Appwrite::Permission
+include Appwrite::Role
 
 client = Client.new
     .set_endpoint('https://<REGION>.cloud.appwrite.io/v1') # Your API Endpoint
@@ -13,7 +15,7 @@ result = databases.update_collection(
     database_id: '<DATABASE_ID>',
     collection_id: '<COLLECTION_ID>',
     name: '<NAME>',
-    permissions: ["read("any")"], # optional
+    permissions: [Permission.read(Role.any())], # optional
     document_security: false, # optional
     enabled: false # optional
 )
diff --git a/docs/examples/databases/update-document.md b/docs/examples/databases/update-document.md
@@ -1,6 +1,8 @@
 require 'appwrite'
 
 include Appwrite
+include Appwrite::Permission
+include Appwrite::Role
 
 client = Client.new
     .set_endpoint('https://<REGION>.cloud.appwrite.io/v1') # Your API Endpoint
@@ -14,6 +16,6 @@ result = databases.update_document(
     collection_id: '<COLLECTION_ID>',
     document_id: '<DOCUMENT_ID>',
     data: {}, # optional
-    permissions: ["read("any")"], # optional
+    permissions: [Permission.read(Role.any())], # optional
     transaction_id: '<TRANSACTION_ID>' # optional
 )
diff --git a/docs/examples/databases/upsert-document.md b/docs/examples/databases/upsert-document.md
@@ -1,6 +1,8 @@
 require 'appwrite'
 
 include Appwrite
+include Appwrite::Permission
+include Appwrite::Role
 
 client = Client.new
     .set_endpoint('https://<REGION>.cloud.appwrite.io/v1') # Your API Endpoint
@@ -14,6 +16,6 @@ result = databases.upsert_document(
     collection_id: '<COLLECTION_ID>',
     document_id: '<DOCUMENT_ID>',
     data: {},
-    permissions: ["read("any")"], # optional
+    permissions: [Permission.read(Role.any())], # optional
     transaction_id: '<TRANSACTION_ID>' # optional
 )
diff --git a/docs/examples/functions/list-deployments.md b/docs/examples/functions/list-deployments.md
@@ -12,5 +12,6 @@ functions = Functions.new(client)
 result = functions.list_deployments(
     function_id: '<FUNCTION_ID>',
     queries: [], # optional
-    search: '<SEARCH>' # optional
+    search: '<SEARCH>', # optional
+    total: false # optional
 )
diff --git a/docs/examples/functions/list-executions.md b/docs/examples/functions/list-executions.md
@@ -11,5 +11,6 @@ functions = Functions.new(client)
 
 result = functions.list_executions(
     function_id: '<FUNCTION_ID>',
-    queries: [] # optional
+    queries: [], # optional
+    total: false # optional
 )
diff --git a/docs/examples/functions/list.md b/docs/examples/functions/list.md
@@ -11,5 +11,6 @@ functions = Functions.new(client)
 
 result = functions.list(
     queries: [], # optional
-    search: '<SEARCH>' # optional
+    search: '<SEARCH>', # optional
+    total: false # optional
 )
diff --git a/docs/examples/messaging/create-resend-provider.md b/docs/examples/messaging/create-resend-provider.md
@@ -0,0 +1,21 @@
+require 'appwrite'
+
+include Appwrite
+
+client = Client.new
+    .set_endpoint('https://<REGION>.cloud.appwrite.io/v1') # Your API Endpoint
+    .set_project('<YOUR_PROJECT_ID>') # Your project ID
+    .set_key('<YOUR_API_KEY>') # Your secret API key
+
+messaging = Messaging.new(client)
+
+result = messaging.create_resend_provider(
+    provider_id: '<PROVIDER_ID>',
+    name: '<NAME>',
+    api_key: '<API_KEY>', # optional
+    from_name: '<FROM_NAME>', # optional
+    from_email: 'email@example.com', # optional
+    reply_to_name: '<REPLY_TO_NAME>', # optional
+    reply_to_email: 'email@example.com', # optional
+    enabled: false # optional
+)
diff --git a/docs/examples/messaging/list-message-logs.md b/docs/examples/messaging/list-message-logs.md
@@ -11,5 +11,6 @@ messaging = Messaging.new(client)
 
 result = messaging.list_message_logs(
     message_id: '<MESSAGE_ID>',
-    queries: [] # optional
+    queries: [], # optional
+    total: false # optional
 )
diff --git a/docs/examples/messaging/list-messages.md b/docs/examples/messaging/list-messages.md
@@ -11,5 +11,6 @@ messaging = Messaging.new(client)
 
 result = messaging.list_messages(
     queries: [], # optional
-    search: '<SEARCH>' # optional
+    search: '<SEARCH>', # optional
+    total: false # optional
 )
diff --git a/docs/examples/messaging/list-provider-logs.md b/docs/examples/messaging/list-provider-logs.md
@@ -11,5 +11,6 @@ messaging = Messaging.new(client)
 
 result = messaging.list_provider_logs(
     provider_id: '<PROVIDER_ID>',
-    queries: [] # optional
+    queries: [], # optional
+    total: false # optional
 )
diff --git a/docs/examples/messaging/list-providers.md b/docs/examples/messaging/list-providers.md
@@ -11,5 +11,6 @@ messaging = Messaging.new(client)
 
 result = messaging.list_providers(
     queries: [], # optional
-    search: '<SEARCH>' # optional
+    search: '<SEARCH>', # optional
+    total: false # optional
 )
diff --git a/docs/examples/messaging/list-subscriber-logs.md b/docs/examples/messaging/list-subscriber-logs.md
@@ -11,5 +11,6 @@ messaging = Messaging.new(client)
 
 result = messaging.list_subscriber_logs(
     subscriber_id: '<SUBSCRIBER_ID>',
-    queries: [] # optional
+    queries: [], # optional
+    total: false # optional
 )
diff --git a/docs/examples/messaging/list-subscribers.md b/docs/examples/messaging/list-subscribers.md
@@ -12,5 +12,6 @@ messaging = Messaging.new(client)
 result = messaging.list_subscribers(
     topic_id: '<TOPIC_ID>',
     queries: [], # optional
-    search: '<SEARCH>' # optional
+    search: '<SEARCH>', # optional
+    total: false # optional
 )
diff --git a/docs/examples/messaging/list-targets.md b/docs/examples/messaging/list-targets.md
@@ -11,5 +11,6 @@ messaging = Messaging.new(client)
 
 result = messaging.list_targets(
     message_id: '<MESSAGE_ID>',
-    queries: [] # optional
+    queries: [], # optional
+    total: false # optional
 )
diff --git a/docs/examples/messaging/list-topic-logs.md b/docs/examples/messaging/list-topic-logs.md
@@ -11,5 +11,6 @@ messaging = Messaging.new(client)
 
 result = messaging.list_topic_logs(
     topic_id: '<TOPIC_ID>',
-    queries: [] # optional
+    queries: [], # optional
+    total: false # optional
 )
diff --git a/docs/examples/messaging/list-topics.md b/docs/examples/messaging/list-topics.md
@@ -11,5 +11,6 @@ messaging = Messaging.new(client)
 
 result = messaging.list_topics(
     queries: [], # optional
-    search: '<SEARCH>' # optional
+    search: '<SEARCH>', # optional
+    total: false # optional
 )
diff --git a/docs/examples/messaging/update-resend-provider.md b/docs/examples/messaging/update-resend-provider.md
@@ -0,0 +1,21 @@
+require 'appwrite'
+
+include Appwrite
+
+client = Client.new
+    .set_endpoint('https://<REGION>.cloud.appwrite.io/v1') # Your API Endpoint
+    .set_project('<YOUR_PROJECT_ID>') # Your project ID
+    .set_key('<YOUR_API_KEY>') # Your secret API key
+
+messaging = Messaging.new(client)
+
+result = messaging.update_resend_provider(
+    provider_id: '<PROVIDER_ID>',
+    name: '<NAME>', # optional
+    enabled: false, # optional
+    api_key: '<API_KEY>', # optional
+    from_name: '<FROM_NAME>', # optional
+    from_email: 'email@example.com', # optional
+    reply_to_name: '<REPLY_TO_NAME>', # optional
+    reply_to_email: '<REPLY_TO_EMAIL>' # optional
+)
diff --git a/docs/examples/sites/list-deployments.md b/docs/examples/sites/list-deployments.md
@@ -12,5 +12,6 @@ sites = Sites.new(client)
 result = sites.list_deployments(
     site_id: '<SITE_ID>',
     queries: [], # optional
-    search: '<SEARCH>' # optional
+    search: '<SEARCH>', # optional
+    total: false # optional
 )
diff --git a/docs/examples/sites/list-logs.md b/docs/examples/sites/list-logs.md
@@ -11,5 +11,6 @@ sites = Sites.new(client)
 
 result = sites.list_logs(
     site_id: '<SITE_ID>',
-    queries: [] # optional
+    queries: [], # optional
+    total: false # optional
 )
diff --git a/docs/examples/sites/list.md b/docs/examples/sites/list.md
@@ -11,5 +11,6 @@ sites = Sites.new(client)
 
 result = sites.list(
     queries: [], # optional
-    search: '<SEARCH>' # optional
+    search: '<SEARCH>', # optional
+    total: false # optional
 )
diff --git a/docs/examples/storage/create-bucket.md b/docs/examples/storage/create-bucket.md
@@ -1,6 +1,8 @@
 require 'appwrite'
 
 include Appwrite
+include Appwrite::Permission
+include Appwrite::Role
 
 client = Client.new
     .set_endpoint('https://<REGION>.cloud.appwrite.io/v1') # Your API Endpoint
@@ -12,7 +14,7 @@ storage = Storage.new(client)
 result = storage.create_bucket(
     bucket_id: '<BUCKET_ID>',
     name: '<NAME>',
-    permissions: ["read("any")"], # optional
+    permissions: [Permission.read(Role.any())], # optional
     file_security: false, # optional
     enabled: false, # optional
     maximum_file_size: 1, # optional

diff --git a/docs/examples/storage/create-file.md b/docs/examples/storage/create-file.md
@@ -1,6 +1,8 @@
 require 'appwrite'
 
 include Appwrite
+include Appwrite::Permission
+include Appwrite::Role
 
 client = Client.new
     .set_endpoint('https://<REGION>.cloud.appwrite.io/v1') # Your API Endpoint
@@ -13,5 +15,5 @@ result = storage.create_file(
     bucket_id: '<BUCKET_ID>',
     file_id: '<FILE_ID>',
     file: InputFile.from_path('dir/file.png'),
-    permissions: ["read("any")"] # optional
+    permissions: [Permission.read(Role.any())] # optional
 )
diff --git a/docs/examples/storage/list-buckets.md b/docs/examples/storage/list-buckets.md
@@ -11,5 +11,6 @@ storage = Storage.new(client)
 
 result = storage.list_buckets(
     queries: [], # optional
-    search: '<SEARCH>' # optional
+    search: '<SEARCH>', # optional
+    total: false # optional
 )
diff --git a/docs/examples/storage/list-files.md b/docs/examples/storage/list-files.md
@@ -12,5 +12,6 @@ storage = Storage.new(client)
 result = storage.list_files(
     bucket_id: '<BUCKET_ID>',
     queries: [], # optional
-    search: '<SEARCH>' # optional
+    search: '<SEARCH>', # optional
+    total: false # optional
 )
diff --git a/docs/examples/storage/update-bucket.md b/docs/examples/storage/update-bucket.md
@@ -1,6 +1,8 @@
 require 'appwrite'
 
 include Appwrite
+include Appwrite::Permission
+include Appwrite::Role
 
 client = Client.new
     .set_endpoint('https://<REGION>.cloud.appwrite.io/v1') # Your API Endpoint
@@ -12,7 +14,7 @@ storage = Storage.new(client)
 result = storage.update_bucket(
     bucket_id: '<BUCKET_ID>',
     name: '<NAME>',
-    permissions: ["read("any")"], # optional
+    permissions: [Permission.read(Role.any())], # optional
     file_security: false, # optional
     enabled: false, # optional
     maximum_file_size: 1, # optional