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
 
+## 17.5.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 `createResendProvider` and `updateResendProvider` methods to `Messaging` service
+
 ## 17.4.1
 
 * Add transaction support for Databases and TablesDB

diff --git a/docs/account.md b/docs/account.md
@@ -51,6 +51,7 @@ GET https://cloud.appwrite.io/v1/account/identities
 | Field Name | Type | Description | Default |
 | --- | --- | --- | --- |
 | queries | array | Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of 100 queries are allowed, each 4096 characters long. You may filter on the following attributes: userId, provider, providerUid, providerEmail, providerAccessTokenExpiry | [] |
+| total | boolean | When set to false, the total count returned will be 0 and will not be calculated. | 1 |
 
 
 ```http request
@@ -84,6 +85,7 @@ GET https://cloud.appwrite.io/v1/account/logs
 | Field Name | Type | Description | Default |
 | --- | --- | --- | --- |
 | queries | array | Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Only supported methods are limit and offset | [] |
+| total | boolean | When set to false, the total count returned will be 0 and will not be calculated. | 1 |
 
 
 ```http request

diff --git a/docs/databases.md b/docs/databases.md
@@ -13,6 +13,7 @@ GET https://cloud.appwrite.io/v1/databases
 | --- | --- | --- | --- |
 | queries | array | Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of 100 queries are allowed, each 4096 characters long. You may filter on the following attributes: name | [] |
 | search | string | Search term to filter your list results. Max length: 256 chars. |  |
+| total | boolean | When set to false, the total count returned will be 0 and will not be calculated. | 1 |
 
 
 ```http request
@@ -166,6 +167,7 @@ GET https://cloud.appwrite.io/v1/databases/{databaseId}/collections
 | databaseId | string | **Required** Database ID. |  |
 | queries | array | Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of 100 queries are allowed, each 4096 characters long. You may filter on the following attributes: name, enabled, documentSecurity | [] |
 | search | string | Search term to filter your list results. Max length: 256 chars. |  |
+| total | boolean | When set to false, the total count returned will be 0 and will not be calculated. | 1 |
 
 
 ```http request
@@ -245,6 +247,7 @@ GET https://cloud.appwrite.io/v1/databases/{databaseId}/collections/{collectionI
 | databaseId | string | **Required** Database ID. |  |
 | collectionId | string | **Required** Collection ID. |  |
 | queries | array | Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of 100 queries are allowed, each 4096 characters long. You may filter on the following attributes: key, type, size, required, array, status, error | [] |
+| total | boolean | When set to false, the total count returned will be 0 and will not be calculated. | 1 |
 
 
 ```http request
@@ -787,6 +790,7 @@ GET https://cloud.appwrite.io/v1/databases/{databaseId}/collections/{collectionI
 | collectionId | string | **Required** Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection). |  |
 | queries | array | Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of 100 queries are allowed, each 4096 characters long. | [] |
 | transactionId | string | Transaction ID to read uncommitted changes within the transaction. |  |
+| total | boolean | When set to false, the total count returned will be 0 and will not be calculated. | 1 |
 
 
 ```http request
@@ -993,6 +997,7 @@ GET https://cloud.appwrite.io/v1/databases/{databaseId}/collections/{collectionI
 | databaseId | string | **Required** Database ID. |  |
 | collectionId | string | **Required** Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection). |  |
 | queries | array | Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of 100 queries are allowed, each 4096 characters long. You may filter on the following attributes: key, type, status, attributes, error | [] |
+| total | boolean | When set to false, the total count returned will be 0 and will not be calculated. | 1 |
 
 
 ```http request

diff --git a/docs/examples/account/list-identities.md b/docs/examples/account/list-identities.md
@@ -11,5 +11,6 @@ $client = (new Client())
 $account = new Account($client);
 
 $result = $account->listIdentities(
-    queries: [] // optional
+    queries: [], // optional
+    total: false // optional
 );
diff --git a/docs/examples/account/list-logs.md b/docs/examples/account/list-logs.md
@@ -11,5 +11,6 @@ $client = (new Client())
 $account = new Account($client);
 
 $result = $account->listLogs(
-    queries: [] // optional
+    queries: [], // optional
+    total: false // optional
 );
diff --git a/docs/examples/databases/create-collection.md b/docs/examples/databases/create-collection.md
@@ -2,6 +2,8 @@
 
 use Appwrite\Client;
 use Appwrite\Services\Databases;
+use Appwrite\Permission;
+use Appwrite\Role;
 
 $client = (new Client())
     ->setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
@@ -14,7 +16,7 @@ $result = $databases->createCollection(
     databaseId: '<DATABASE_ID>',
     collectionId: '<COLLECTION_ID>',
     name: '<NAME>',
-    permissions: ["read("any")"], // optional
+    permissions: [Permission::read(Role::any())], // optional
     documentSecurity: false, // optional
     enabled: false // optional
 );
diff --git a/docs/examples/databases/create-document.md b/docs/examples/databases/create-document.md
@@ -2,6 +2,8 @@
 
 use Appwrite\Client;
 use Appwrite\Services\Databases;
+use Appwrite\Permission;
+use Appwrite\Role;
 
 $client = (new Client())
     ->setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
@@ -21,6 +23,6 @@ $result = $databases->createDocument(
         'age' => 30,
         'isAdmin' => false
     ],
-    permissions: ["read("any")"], // optional
+    permissions: [Permission::read(Role::any())], // optional
     transactionId: '<TRANSACTION_ID>' // optional
 );
diff --git a/docs/examples/databases/list-attributes.md b/docs/examples/databases/list-attributes.md
@@ -13,5 +13,6 @@ $databases = new Databases($client);
 $result = $databases->listAttributes(
     databaseId: '<DATABASE_ID>',
     collectionId: '<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
@@ -13,5 +13,6 @@ $databases = new Databases($client);
 $result = $databases->listCollections(
     databaseId: '<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
@@ -14,5 +14,6 @@ $result = $databases->listDocuments(
     databaseId: '<DATABASE_ID>',
     collectionId: '<COLLECTION_ID>',
     queries: [], // optional
-    transactionId: '<TRANSACTION_ID>' // optional
+    transactionId: '<TRANSACTION_ID>', // optional
+    total: false // optional
 );
diff --git a/docs/examples/databases/list-indexes.md b/docs/examples/databases/list-indexes.md
@@ -13,5 +13,6 @@ $databases = new Databases($client);
 $result = $databases->listIndexes(
     databaseId: '<DATABASE_ID>',
     collectionId: '<COLLECTION_ID>',
-    queries: [] // optional
+    queries: [], // optional
+    total: false // optional
 );
diff --git a/docs/examples/databases/list.md b/docs/examples/databases/list.md
@@ -12,5 +12,6 @@ $databases = new Databases($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
@@ -2,6 +2,8 @@
 
 use Appwrite\Client;
 use Appwrite\Services\Databases;
+use Appwrite\Permission;
+use Appwrite\Role;
 
 $client = (new Client())
     ->setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
@@ -14,7 +16,7 @@ $result = $databases->updateCollection(
     databaseId: '<DATABASE_ID>',
     collectionId: '<COLLECTION_ID>',
     name: '<NAME>',
-    permissions: ["read("any")"], // optional
+    permissions: [Permission::read(Role::any())], // optional
     documentSecurity: false, // optional
     enabled: false // optional
 );
diff --git a/docs/examples/databases/update-document.md b/docs/examples/databases/update-document.md
@@ -2,6 +2,8 @@
 
 use Appwrite\Client;
 use Appwrite\Services\Databases;
+use Appwrite\Permission;
+use Appwrite\Role;
 
 $client = (new Client())
     ->setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
@@ -15,6 +17,6 @@ $result = $databases->updateDocument(
     collectionId: '<COLLECTION_ID>',
     documentId: '<DOCUMENT_ID>',
     data: [], // optional
-    permissions: ["read("any")"], // optional
+    permissions: [Permission::read(Role::any())], // optional
     transactionId: '<TRANSACTION_ID>' // optional
 );
diff --git a/docs/examples/databases/upsert-document.md b/docs/examples/databases/upsert-document.md
@@ -2,6 +2,8 @@
 
 use Appwrite\Client;
 use Appwrite\Services\Databases;
+use Appwrite\Permission;
+use Appwrite\Role;
 
 $client = (new Client())
     ->setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
@@ -15,6 +17,6 @@ $result = $databases->upsertDocument(
     collectionId: '<COLLECTION_ID>',
     documentId: '<DOCUMENT_ID>',
     data: [],
-    permissions: ["read("any")"], // optional
+    permissions: [Permission::read(Role::any())], // optional
     transactionId: '<TRANSACTION_ID>' // optional
 );
diff --git a/docs/examples/functions/list-deployments.md b/docs/examples/functions/list-deployments.md
@@ -13,5 +13,6 @@ $functions = new Functions($client);
 $result = $functions->listDeployments(
     functionId: '<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
@@ -12,5 +12,6 @@ $functions = new Functions($client);
 
 $result = $functions->listExecutions(
     functionId: '<FUNCTION_ID>',
-    queries: [] // optional
+    queries: [], // optional
+    total: false // optional
 );
diff --git a/docs/examples/functions/list.md b/docs/examples/functions/list.md
@@ -12,5 +12,6 @@ $functions = new Functions($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,22 @@
+<?php
+
+use Appwrite\Client;
+use Appwrite\Services\Messaging;
+
+$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 = new Messaging($client);
+
+$result = $messaging->createResendProvider(
+    providerId: '<PROVIDER_ID>',
+    name: '<NAME>',
+    apiKey: '<API_KEY>', // optional
+    fromName: '<FROM_NAME>', // optional
+    fromEmail: 'email@example.com', // optional
+    replyToName: '<REPLY_TO_NAME>', // optional
+    replyToEmail: '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
@@ -12,5 +12,6 @@ $messaging = new Messaging($client);
 
 $result = $messaging->listMessageLogs(
     messageId: '<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
@@ -12,5 +12,6 @@ $messaging = new Messaging($client);
 
 $result = $messaging->listMessages(
     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
@@ -12,5 +12,6 @@ $messaging = new Messaging($client);
 
 $result = $messaging->listProviderLogs(
     providerId: '<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
@@ -12,5 +12,6 @@ $messaging = new Messaging($client);
 
 $result = $messaging->listProviders(
     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
@@ -12,5 +12,6 @@ $messaging = new Messaging($client);
 
 $result = $messaging->listSubscriberLogs(
     subscriberId: '<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
@@ -13,5 +13,6 @@ $messaging = new Messaging($client);
 $result = $messaging->listSubscribers(
     topicId: '<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
@@ -12,5 +12,6 @@ $messaging = new Messaging($client);
 
 $result = $messaging->listTargets(
     messageId: '<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
@@ -12,5 +12,6 @@ $messaging = new Messaging($client);
 
 $result = $messaging->listTopicLogs(
     topicId: '<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
@@ -12,5 +12,6 @@ $messaging = new Messaging($client);
 
 $result = $messaging->listTopics(
     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,22 @@
+<?php
+
+use Appwrite\Client;
+use Appwrite\Services\Messaging;
+
+$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 = new Messaging($client);
+
+$result = $messaging->updateResendProvider(
+    providerId: '<PROVIDER_ID>',
+    name: '<NAME>', // optional
+    enabled: false, // optional
+    apiKey: '<API_KEY>', // optional
+    fromName: '<FROM_NAME>', // optional
+    fromEmail: 'email@example.com', // optional
+    replyToName: '<REPLY_TO_NAME>', // optional
+    replyToEmail: '<REPLY_TO_EMAIL>' // optional
+);
diff --git a/docs/examples/sites/list-deployments.md b/docs/examples/sites/list-deployments.md
@@ -13,5 +13,6 @@ $sites = new Sites($client);
 $result = $sites->listDeployments(
     siteId: '<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
@@ -12,5 +12,6 @@ $sites = new Sites($client);
 
 $result = $sites->listLogs(
     siteId: '<SITE_ID>',
-    queries: [] // optional
+    queries: [], // optional
+    total: false // optional
 );