ArnabChatterjee20k · Oct 6, 2026 · Oct 6, 2026 · Oct 6, 2026 · Oct 6, 2026 · Oct 6, 2026
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,16 @@
 # Change Log
 
+## 30.0.0-rc.2
+
+* Added: OAuth2 provider `prompt` enums (`OAuth2Auth0Prompt`, `OAuth2GithubPrompt`, and project variants)
+* Added: `Topic` and `ResolvedTopic` exports
+* Added: `Models.Account` and `Models.OAuth2Webflow` types
+* Added: `Webflow` to the `OAuthProvider` and `ProjectOAuthProviderId` enums
+* Added: `avatars.updatePhoto()` and `avatars.deletePhoto()` methods
+* Added: optional `total` param on locale and list endpoints; `duration` on email-password sessions
+* Updated: `chunkedUpload` supports a `text` responseType and falls back without a file
+* Updated: several model fields relaxed to optional; `RestorationStatus.options` is now an object
+
 ## 30.0.0
 
 * Breaking: `account.listLogs`, `users.listLogs`, `Log` and `LogList` removed

diff --git a/README.md b/README.md
@@ -6,7 +6,7 @@
 [![Twitter Account](https://img.shields.io/twitter/follow/appwrite?color=00acee&label=twitter&style=flat-square)](https://twitter.com/appwrite)
 [![Discord](https://img.shields.io/discord/564160730845151244?label=discord&style=flat-square)](https://appwrite.io/discord)
 
-**This SDK targets Appwrite server version latest as shipped on Appwrite Cloud.** Self-hosted releases can lag behind Cloud — if you run an older self-hosted build, use a matching older SDK from [previous releases](https://github.com/appwrite/sdk-for-node/releases) when APIs differ.
+**This SDK targets Appwrite server version 2.3.x as shipped on Appwrite Cloud.** Self-hosted releases can lag behind Cloud — if you run an older self-hosted build, use a matching older SDK from [previous releases](https://github.com/appwrite/sdk-for-node/releases) when APIs differ.
 
  > This is the Node.js SDK for integrating with Appwrite from your Node.js server-side code.
                             If you're looking to integrate from the browser, you should check [appwrite/sdk-for-web](https://github.com/appwrite/sdk-for-web)

diff --git a/docs/examples/account/create-email-password-session.md b/docs/examples/account/create-email-password-session.md
@@ -11,5 +11,6 @@ const account = new sdk.Account(client);
 const result = await account.createEmailPasswordSession({
     email: 'email@example.com',
     password: 'password',
+    duration: 60, // optional
 });
 ```
diff --git a/docs/examples/account/delete-sessions.md b/docs/examples/account/delete-sessions.md
@@ -8,5 +8,7 @@ const client = new sdk.Client()
 
 const account = new sdk.Account(client);
 
-const result = await account.deleteSessions();
+const result = await account.deleteSessions({
+    current: false, // optional
+});
 ```
diff --git a/docs/examples/account/list-sessions.md b/docs/examples/account/list-sessions.md
@@ -8,5 +8,7 @@ const client = new sdk.Client()
 
 const account = new sdk.Account(client);
 
-const result = await account.listSessions();
+const result = await account.listSessions({
+    total: false, // optional
+});
 ```
diff --git a/docs/examples/avatars/delete-photo.md b/docs/examples/avatars/delete-photo.md
@@ -0,0 +1,12 @@
+```javascript
+const sdk = require('node-appwrite');
+
+const client = new sdk.Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>') // Your project ID
+    .setSession(''); // The user session to authenticate with
+
+const avatars = new sdk.Avatars(client);
+
+const result = await avatars.deletePhoto();
+```
diff --git a/docs/examples/avatars/get-screenshot.md b/docs/examples/avatars/get-screenshot.md
@@ -11,8 +11,7 @@ const avatars = new sdk.Avatars(client);
 const result = await avatars.getScreenshot({
     url: 'https://example.com',
     headers: {
-        Authorization: 'Bearer token123',
-        'X-Custom-Header': 'value',
+        'Accept-Language': 'en-US,en;q=0.9',
     }, // optional
     viewportWidth: 1920, // optional
     viewportHeight: 1080, // optional

diff --git a/docs/examples/avatars/update-photo.md b/docs/examples/avatars/update-photo.md
@@ -0,0 +1,15 @@
+```javascript
+const sdk = require('node-appwrite');
+const { InputFile } = require('node-appwrite/file');
+
+const client = new sdk.Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>') // Your project ID
+    .setSession(''); // The user session to authenticate with
+
+const avatars = new sdk.Avatars(client);
+
+const result = await avatars.updatePhoto({
+    file: InputFile.fromPath('/path/to/file', 'filename'),
+});
+```
diff --git a/docs/examples/databases/create-documents.md b/docs/examples/databases/create-documents.md
@@ -11,7 +11,16 @@ const databases = new sdk.Databases(client);
 const result = await databases.createDocuments({
     databaseId: '<DATABASE_ID>',
     collectionId: '<COLLECTION_ID>',
-    documents: [],
+    documents: [
+        {
+            $id: 'example1',
+            username: 'walter.obrien',
+            email: 'walter.obrien@example.com',
+            fullName: "Walter O'Brien",
+            age: 30,
+            isAdmin: false,
+        },
+    ],
     transactionId: '<TRANSACTION_ID>', // optional
 });
 ```
diff --git a/docs/examples/databases/create-index.md b/docs/examples/databases/create-index.md
@@ -13,7 +13,7 @@ const result = await databases.createIndex({
     collectionId: '<COLLECTION_ID>',
     key: '<KEY>',
     type: sdk.DatabasesIndexType.Key,
-    attributes: [],
+    attributes: ['username'],
     orders: [sdk.OrderBy.Asc], // optional
     lengths: [], // optional
 });

diff --git a/docs/examples/databases/delete-documents.md b/docs/examples/databases/delete-documents.md
@@ -11,7 +11,9 @@ const databases = new sdk.Databases(client);
 const result = await databases.deleteDocuments({
     databaseId: '<DATABASE_ID>',
     collectionId: '<COLLECTION_ID>',
-    queries: [], // optional
+    queries: [
+        '{"method":"equal", "attribute":"$id", "values":["<DOCUMENT_ID>"]}',
+    ], // optional
     transactionId: '<TRANSACTION_ID>', // optional
 });
 ```
diff --git a/docs/examples/databases/list-transactions.md b/docs/examples/databases/list-transactions.md
@@ -10,5 +10,6 @@ const databases = new sdk.Databases(client);
 
 const result = await databases.listTransactions({
     queries: [], // optional
+    total: false, // optional
 });
 ```
diff --git a/docs/examples/databases/upsert-documents.md b/docs/examples/databases/upsert-documents.md
@@ -11,7 +11,16 @@ const databases = new sdk.Databases(client);
 const result = await databases.upsertDocuments({
     databaseId: '<DATABASE_ID>',
     collectionId: '<COLLECTION_ID>',
-    documents: [],
+    documents: [
+        {
+            $id: 'example1',
+            username: 'walter.obrien',
+            email: 'walter.obrien@example.com',
+            fullName: "Walter O'Brien",
+            age: 30,
+            isAdmin: false,
+        },
+    ],
     transactionId: '<TRANSACTION_ID>', // optional
 });
 ```
diff --git a/docs/examples/documentsdb/create-documents.md b/docs/examples/documentsdb/create-documents.md
@@ -11,7 +11,16 @@ const documentsDB = new sdk.DocumentsDB(client);
 const result = await documentsDB.createDocuments({
     databaseId: '<DATABASE_ID>',
     collectionId: '<COLLECTION_ID>',
-    documents: [],
+    documents: [
+        {
+            $id: 'example1',
+            username: 'walter.obrien',
+            email: 'walter.obrien@example.com',
+            fullName: "Walter O'Brien",
+            age: 30,
+            isAdmin: false,
+        },
+    ],
     transactionId: '<TRANSACTION_ID>', // optional
 });
 ```
diff --git a/docs/examples/documentsdb/create-index.md b/docs/examples/documentsdb/create-index.md
@@ -13,7 +13,7 @@ const result = await documentsDB.createIndex({
     collectionId: '<COLLECTION_ID>',
     key: '<KEY>',
     type: sdk.DocumentsDBIndexType.Key,
-    attributes: [],
+    attributes: ['username'],
     orders: [sdk.OrderBy.Asc], // optional
     lengths: [], // optional
 });

diff --git a/docs/examples/documentsdb/delete-documents.md b/docs/examples/documentsdb/delete-documents.md
@@ -11,7 +11,9 @@ const documentsDB = new sdk.DocumentsDB(client);
 const result = await documentsDB.deleteDocuments({
     databaseId: '<DATABASE_ID>',
     collectionId: '<COLLECTION_ID>',
-    queries: [], // optional
+    queries: [
+        '{"method":"equal", "attribute":"$id", "values":["<DOCUMENT_ID>"]}',
+    ], // optional
     transactionId: '<TRANSACTION_ID>', // optional
 });
 ```
diff --git a/docs/examples/documentsdb/list-transactions.md b/docs/examples/documentsdb/list-transactions.md
@@ -10,5 +10,6 @@ const documentsDB = new sdk.DocumentsDB(client);
 
 const result = await documentsDB.listTransactions({
     queries: [], // optional
+    total: false, // optional
 });
 ```
diff --git a/docs/examples/documentsdb/upsert-documents.md b/docs/examples/documentsdb/upsert-documents.md
@@ -11,7 +11,16 @@ const documentsDB = new sdk.DocumentsDB(client);
 const result = await documentsDB.upsertDocuments({
     databaseId: '<DATABASE_ID>',
     collectionId: '<COLLECTION_ID>',
-    documents: [],
+    documents: [
+        {
+            $id: 'example1',
+            username: 'walter.obrien',
+            email: 'walter.obrien@example.com',
+            fullName: "Walter O'Brien",
+            age: 30,
+            isAdmin: false,
+        },
+    ],
     transactionId: '<TRANSACTION_ID>', // optional
 });
 ```
diff --git a/docs/examples/embeddings/create-text-embeddings.md b/docs/examples/embeddings/create-text-embeddings.md
@@ -9,7 +9,10 @@ const client = new sdk.Client()
 const embeddings = new sdk.Embeddings(client);
 
 const result = await embeddings.createTextEmbeddings({
-    texts: [],
+    texts: [
+        'Appwrite helps developers build applications.',
+        'Find documents with semantic search.',
+    ],
     model: sdk.EmbeddingModel.NomicEmbedText, // optional
 });
 ```
diff --git a/docs/examples/functions/create-deployment.md b/docs/examples/functions/create-deployment.md
@@ -1,6 +1,6 @@
 ```javascript
 const sdk = require('node-appwrite');
-const fs = require('fs');
+const { InputFile } = require('node-appwrite/file');
 
 const client = new sdk.Client()
     .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint

diff --git a/docs/examples/functions/list-runtimes.md b/docs/examples/functions/list-runtimes.md
@@ -8,5 +8,7 @@ const client = new sdk.Client()
 
 const functions = new sdk.Functions(client);
 
-const result = await functions.listRuntimes();
+const result = await functions.listRuntimes({
+    total: false, // optional
+});
 ```
diff --git a/docs/examples/functions/list-specifications.md b/docs/examples/functions/list-specifications.md
@@ -10,5 +10,6 @@ const functions = new sdk.Functions(client);
 
 const result = await functions.listSpecifications({
     type: 'runtimes', // optional
+    total: false, // optional
 });
 ```
diff --git a/docs/examples/graphql/mutation.md b/docs/examples/graphql/mutation.md
@@ -9,6 +9,8 @@ const client = new sdk.Client()
 const graphql = new sdk.Graphql(client);
 
 const result = await graphql.mutation({
-    query: {},
+    query: {
+        query: 'mutation { accountUpdateName(name: "Walter") { name } }',
+    },
 });
 ```
diff --git a/docs/examples/graphql/query.md b/docs/examples/graphql/query.md
@@ -9,6 +9,8 @@ const client = new sdk.Client()
 const graphql = new sdk.Graphql(client);
 
 const result = await graphql.query({
-    query: {},
+    query: {
+        query: 'query { localeGet { ip } }',
+    },
 });
 ```
diff --git a/docs/examples/locale/list-codes.md b/docs/examples/locale/list-codes.md
@@ -8,5 +8,7 @@ const client = new sdk.Client()
 
 const locale = new sdk.Locale(client);
 
-const result = await locale.listCodes();
+const result = await locale.listCodes({
+    total: false, // optional
+});
 ```
diff --git a/docs/examples/locale/list-continents.md b/docs/examples/locale/list-continents.md
@@ -8,5 +8,7 @@ const client = new sdk.Client()
 
 const locale = new sdk.Locale(client);
 
-const result = await locale.listContinents();
+const result = await locale.listContinents({
+    total: false, // optional
+});
 ```
diff --git a/docs/examples/locale/list-countries-eu.md b/docs/examples/locale/list-countries-eu.md
@@ -8,5 +8,7 @@ const client = new sdk.Client()
 
 const locale = new sdk.Locale(client);
 
-const result = await locale.listCountriesEU();
+const result = await locale.listCountriesEU({
+    total: false, // optional
+});
 ```
diff --git a/docs/examples/locale/list-countries-phones.md b/docs/examples/locale/list-countries-phones.md
@@ -8,5 +8,7 @@ const client = new sdk.Client()
 
 const locale = new sdk.Locale(client);
 
-const result = await locale.listCountriesPhones();
+const result = await locale.listCountriesPhones({
+    total: false, // optional
+});
 ```
diff --git a/docs/examples/locale/list-countries.md b/docs/examples/locale/list-countries.md
@@ -8,5 +8,7 @@ const client = new sdk.Client()
 
 const locale = new sdk.Locale(client);
 
-const result = await locale.listCountries();
+const result = await locale.listCountries({
+    total: false, // optional
+});
 ```
diff --git a/docs/examples/locale/list-currencies.md b/docs/examples/locale/list-currencies.md
@@ -8,5 +8,7 @@ const client = new sdk.Client()
 
 const locale = new sdk.Locale(client);
 
-const result = await locale.listCurrencies();
+const result = await locale.listCurrencies({
+    total: false, // optional
+});
 ```
diff --git a/docs/examples/locale/list-languages.md b/docs/examples/locale/list-languages.md
@@ -8,5 +8,7 @@ const client = new sdk.Client()
 
 const locale = new sdk.Locale(client);
 
-const result = await locale.listLanguages();
+const result = await locale.listLanguages({
+    total: false, // optional
+});
 ```
diff --git a/docs/examples/messaging/create-push.md b/docs/examples/messaging/create-push.md
@@ -28,5 +28,6 @@ const result = await messaging.createPush({
     contentAvailable: false, // optional
     critical: false, // optional
     priority: sdk.MessagePriority.Normal, // optional
+    channelId: '<CHANNEL_ID>', // optional
 });
 ```
diff --git a/docs/examples/messaging/update-email.md b/docs/examples/messaging/update-email.md
@@ -10,18 +10,18 @@ const messaging = new sdk.Messaging(client);
 
 const result = await messaging.updateEmail({
     messageId: '<MESSAGE_ID>',
+    subject: '<SUBJECT>', // optional
+    content: '<CONTENT>', // optional
     topics: [], // optional
     users: [], // optional
     targets: [], // optional
-    subject: '<SUBJECT>', // optional
-    content: '<CONTENT>', // optional
-    draft: false, // optional
-    html: false, // optional
     cc: [], // optional
     bcc: [], // optional
+    attachments: [], // optional
     replyToEmail: 'email@example.com', // optional
     replyToName: '<REPLY_TO_NAME>', // optional
+    draft: false, // optional
+    html: false, // optional
     scheduledAt: '2020-10-15T06:38:00.000+00:00', // optional
-    attachments: [], // optional
 });
 ```
diff --git a/docs/examples/messaging/update-push.md b/docs/examples/messaging/update-push.md
@@ -10,11 +10,11 @@ const messaging = new sdk.Messaging(client);
 
 const result = await messaging.updatePush({
     messageId: '<MESSAGE_ID>',
+    title: '<TITLE>', // optional
+    body: '<BODY>', // optional
     topics: [], // optional
     users: [], // optional
     targets: [], // optional
-    title: '<TITLE>', // optional
-    body: '<BODY>', // optional
     data: {}, // optional
     action: '<ACTION>', // optional
     image: '<ID1:ID2>', // optional
@@ -28,5 +28,6 @@ const result = await messaging.updatePush({
     contentAvailable: false, // optional
     critical: false, // optional
     priority: sdk.MessagePriority.Normal, // optional
+    channelId: '<CHANNEL_ID>', // optional
 });
 ```
diff --git a/docs/examples/messaging/update-sms.md b/docs/examples/messaging/update-sms.md
@@ -10,10 +10,10 @@ const messaging = new sdk.Messaging(client);
 
 const result = await messaging.updateSMS({
     messageId: '<MESSAGE_ID>',
+    content: '<CONTENT>', // optional
     topics: [], // optional
     users: [], // optional
     targets: [], // optional
-    content: '<CONTENT>', // optional
     draft: false, // optional
     scheduledAt: '2020-10-15T06:38:00.000+00:00', // optional
 });