abnegate · Oct 21, 2026 · Oct 20, 2026 · Oct 20, 2026 · Oct 20, 2026 · Oct 20, 2026
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,13 @@
 # Change Log
 
+## 28.1.0
+
+* Added: `createQuery` on `databases`, `documentsDB` and `tablesDB` to send list queries in the request body
+* Added: `account.listMemberships`
+* Added: `bundleId` and `environment` on `account.createPushTarget` and `account.updatePushTarget` for APNs routing
+* Fixed: OAuth2 sign-in on Windows and Linux returns through a loopback callback and creates the session; a denied sign-in throws its error instead of opening the `failure` URL
+* Fixed: saving the OAuth2 session waits for client initialisation already in progress
+
 ## 28.0.0
 
 * Breaking: requests send `X-Appwrite-Response-Format: 2.5.0`; responses follow the 2.5 shapes

diff --git a/README.md b/README.md
@@ -24,7 +24,7 @@ Or add it to your app's `pubspec.yaml` file and run `flutter pub get`:
 
 ```yaml
 dependencies:
-  appwrite: ^28.0.0
+  appwrite: ^28.1.0
 ```
 
 ### Android requirements

diff --git a/android/build.gradle b/android/build.gradle
@@ -1,7 +1,7 @@
 // The native half of Push on Android: background delivery that survives the process being
 // killed, a reboot and an app update, shared with the Appwrite Android SDK.
 group = "io.appwrite.flutter"
-version = "28.0.0"
+version = "28.1.0"
 
 buildscript {
     ext.kotlin_version = "2.1.0"

diff --git a/docs/examples/account/create-push-target.md b/docs/examples/account/create-push-target.md
@@ -12,5 +12,7 @@ models.Target result = await account.createPushTarget(
     targetId: '<TARGET_ID>',
     identifier: '<IDENTIFIER>',
     providerId: '<PROVIDER_ID>', // optional
+    bundleId: '<BUNDLE_ID>', // optional
+    environment: 'sandbox', // optional
 );
 ```
diff --git a/docs/examples/account/list-memberships.md b/docs/examples/account/list-memberships.md
@@ -0,0 +1,15 @@
+```dart
+import 'package:appwrite/appwrite.dart';
+import 'package:appwrite/models.dart' as models;
+
+Client client = Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>'); // Your project ID
+
+Account account = Account(client);
+
+models.MembershipList result = await account.listMemberships(
+    queries: [], // optional
+    total: false, // optional
+);
+```
diff --git a/docs/examples/account/update-push-target.md b/docs/examples/account/update-push-target.md
@@ -11,5 +11,7 @@ Account account = Account(client);
 models.Target result = await account.updatePushTarget(
     targetId: '<TARGET_ID>',
     identifier: '<IDENTIFIER>',
+    bundleId: '<BUNDLE_ID>', // optional
+    environment: 'sandbox', // optional
 );
 ```
diff --git a/docs/examples/analytics/create-event.md b/docs/examples/analytics/create-event.md
@@ -7,7 +7,7 @@ Client client = Client()
 
 Analytics analytics = Analytics(client);
 
-models. result = await analytics.createEvent(
+await analytics.createEvent(
     propertyId: '<PROPERTY_ID>',
     name: '<NAME>',
     url: 'https://example.com',

diff --git a/docs/examples/avatars/update-photo.md b/docs/examples/avatars/update-photo.md
@@ -1,5 +1,4 @@
 ```dart
-import 'dart:io';
 import 'package:appwrite/appwrite.dart';
 import 'package:appwrite/models.dart' as models;
 

diff --git a/docs/examples/databases/create-document.md b/docs/examples/databases/create-document.md
@@ -1,8 +1,6 @@
 ```dart
 import 'package:appwrite/appwrite.dart';
 import 'package:appwrite/models.dart' as models;
-import 'package:appwrite/permission.dart';
-import 'package:appwrite/role.dart';
 
 Client client = Client()
     .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint

diff --git a/docs/examples/databases/create-query.md b/docs/examples/databases/create-query.md
@@ -0,0 +1,19 @@
+```dart
+import 'package:appwrite/appwrite.dart';
+import 'package:appwrite/models.dart' as models;
+
+Client client = Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>'); // Your project ID
+
+Databases databases = Databases(client);
+
+models.DocumentList result = await databases.createQuery(
+    databaseId: '<DATABASE_ID>',
+    collectionId: '<COLLECTION_ID>',
+    queries: [], // optional
+    transactionId: '<TRANSACTION_ID>', // optional
+    total: false, // optional
+    ttl: 0, // optional
+);
+```
diff --git a/docs/examples/databases/update-document.md b/docs/examples/databases/update-document.md
@@ -1,8 +1,6 @@
 ```dart
 import 'package:appwrite/appwrite.dart';
 import 'package:appwrite/models.dart' as models;
-import 'package:appwrite/permission.dart';
-import 'package:appwrite/role.dart';
 
 Client client = Client()
     .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint

diff --git a/docs/examples/databases/upsert-document.md b/docs/examples/databases/upsert-document.md
@@ -1,8 +1,6 @@
 ```dart
 import 'package:appwrite/appwrite.dart';
 import 'package:appwrite/models.dart' as models;
-import 'package:appwrite/permission.dart';
-import 'package:appwrite/role.dart';
 
 Client client = Client()
     .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint

diff --git a/docs/examples/documentsdb/create-document.md b/docs/examples/documentsdb/create-document.md
@@ -1,8 +1,6 @@
 ```dart
 import 'package:appwrite/appwrite.dart';
 import 'package:appwrite/models.dart' as models;
-import 'package:appwrite/permission.dart';
-import 'package:appwrite/role.dart';
 
 Client client = Client()
     .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint

diff --git a/docs/examples/documentsdb/create-query.md b/docs/examples/documentsdb/create-query.md
@@ -0,0 +1,19 @@
+```dart
+import 'package:appwrite/appwrite.dart';
+import 'package:appwrite/models.dart' as models;
+
+Client client = Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>'); // Your project ID
+
+DocumentsDB documentsDB = DocumentsDB(client);
+
+models.DocumentList result = await documentsDB.createQuery(
+    databaseId: '<DATABASE_ID>',
+    collectionId: '<COLLECTION_ID>',
+    queries: [], // optional
+    transactionId: '<TRANSACTION_ID>', // optional
+    total: false, // optional
+    ttl: 0, // optional
+);
+```
diff --git a/docs/examples/documentsdb/update-document.md b/docs/examples/documentsdb/update-document.md
@@ -1,8 +1,6 @@
 ```dart
 import 'package:appwrite/appwrite.dart';
 import 'package:appwrite/models.dart' as models;
-import 'package:appwrite/permission.dart';
-import 'package:appwrite/role.dart';
 
 Client client = Client()
     .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint

diff --git a/docs/examples/documentsdb/upsert-document.md b/docs/examples/documentsdb/upsert-document.md
@@ -1,8 +1,6 @@
 ```dart
 import 'package:appwrite/appwrite.dart';
 import 'package:appwrite/models.dart' as models;
-import 'package:appwrite/permission.dart';
-import 'package:appwrite/role.dart';
 
 Client client = Client()
     .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint

diff --git a/docs/examples/graphql/mutation.md b/docs/examples/graphql/mutation.md
@@ -1,14 +1,13 @@
 ```dart
 import 'package:appwrite/appwrite.dart';
-import 'package:appwrite/models.dart' as models;
 
 Client client = Client()
     .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
     .setProject('<YOUR_PROJECT_ID>'); // Your project ID
 
 Graphql graphql = Graphql(client);
 
-models.Any result = await graphql.mutation(
+dynamic result = await graphql.mutation(
     query: {
         "query": "mutation { accountUpdateName(name: \"Walter\") { name } }"
     },

diff --git a/docs/examples/graphql/query.md b/docs/examples/graphql/query.md
@@ -1,14 +1,13 @@
 ```dart
 import 'package:appwrite/appwrite.dart';
-import 'package:appwrite/models.dart' as models;
 
 Client client = Client()
     .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
     .setProject('<YOUR_PROJECT_ID>'); // Your project ID
 
 Graphql graphql = Graphql(client);
 
-models.Any result = await graphql.query(
+dynamic result = await graphql.query(
     query: {
         "query": "query { localeGet { ip } }"
     },

diff --git a/docs/examples/oauth2/logout-post.md b/docs/examples/oauth2/logout-post.md
@@ -7,7 +7,7 @@ Client client = Client()
 
 Oauth2 oauth2 = Oauth2(client);
 
-models. result = await oauth2.logoutPost(
+await oauth2.logoutPost(
     idTokenHint: '<ID_TOKEN_HINT>', // optional
     logoutHint: '<LOGOUT_HINT>', // optional
     clientId: '<CLIENT_ID>', // optional

diff --git a/docs/examples/oauth2/logout.md b/docs/examples/oauth2/logout.md
@@ -7,7 +7,7 @@ Client client = Client()
 
 Oauth2 oauth2 = Oauth2(client);
 
-models. result = await oauth2.logout(
+await oauth2.logout(
     idTokenHint: '<ID_TOKEN_HINT>', // optional
     logoutHint: '<LOGOUT_HINT>', // optional
     clientId: '<CLIENT_ID>', // optional

diff --git a/docs/examples/oauth2/revoke.md b/docs/examples/oauth2/revoke.md
@@ -7,7 +7,7 @@ Client client = Client()
 
 Oauth2 oauth2 = Oauth2(client);
 
-models. result = await oauth2.revoke(
+await oauth2.revoke(
     token: '<TOKEN>',
     tokenTypeHint: 'access_token', // optional
     clientId: '<CLIENT_ID>', // optional

diff --git a/docs/examples/presences/update.md b/docs/examples/presences/update.md
@@ -1,8 +1,6 @@
 ```dart
 import 'package:appwrite/appwrite.dart';
 import 'package:appwrite/models.dart' as models;
-import 'package:appwrite/permission.dart';
-import 'package:appwrite/role.dart';
 
 Client client = Client()
     .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint

diff --git a/docs/examples/presences/upsert.md b/docs/examples/presences/upsert.md
@@ -1,8 +1,6 @@
 ```dart
 import 'package:appwrite/appwrite.dart';
 import 'package:appwrite/models.dart' as models;
-import 'package:appwrite/permission.dart';
-import 'package:appwrite/role.dart';
 
 Client client = Client()
     .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint

diff --git a/docs/examples/storage/create-file.md b/docs/examples/storage/create-file.md
@@ -1,9 +1,6 @@
 ```dart
-import 'dart:io';
 import 'package:appwrite/appwrite.dart';
 import 'package:appwrite/models.dart' as models;
-import 'package:appwrite/permission.dart';
-import 'package:appwrite/role.dart';
 
 Client client = Client()
     .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint

diff --git a/docs/examples/storage/update-file.md b/docs/examples/storage/update-file.md
@@ -1,8 +1,6 @@
 ```dart
 import 'package:appwrite/appwrite.dart';
 import 'package:appwrite/models.dart' as models;
-import 'package:appwrite/permission.dart';
-import 'package:appwrite/role.dart';
 
 Client client = Client()
     .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint

diff --git a/docs/examples/tablesdb/create-query.md b/docs/examples/tablesdb/create-query.md
@@ -0,0 +1,19 @@
+```dart
+import 'package:appwrite/appwrite.dart';
+import 'package:appwrite/models.dart' as models;
+
+Client client = Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>'); // Your project ID
+
+TablesDB tablesDB = TablesDB(client);
+
+models.RowList result = await tablesDB.createQuery(
+    databaseId: '<DATABASE_ID>',
+    tableId: '<TABLE_ID>',
+    queries: [], // optional
+    transactionId: '<TRANSACTION_ID>', // optional
+    total: false, // optional
+    ttl: 0, // optional
+);
+```
diff --git a/docs/examples/tablesdb/create-row.md b/docs/examples/tablesdb/create-row.md
@@ -1,8 +1,6 @@
 ```dart
 import 'package:appwrite/appwrite.dart';
 import 'package:appwrite/models.dart' as models;
-import 'package:appwrite/permission.dart';
-import 'package:appwrite/role.dart';
 
 Client client = Client()
     .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint

diff --git a/docs/examples/tablesdb/update-row.md b/docs/examples/tablesdb/update-row.md
@@ -1,8 +1,6 @@
 ```dart
 import 'package:appwrite/appwrite.dart';
 import 'package:appwrite/models.dart' as models;
-import 'package:appwrite/permission.dart';
-import 'package:appwrite/role.dart';
 
 Client client = Client()
     .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint

diff --git a/docs/examples/tablesdb/upsert-row.md b/docs/examples/tablesdb/upsert-row.md
@@ -1,8 +1,6 @@
 ```dart
 import 'package:appwrite/appwrite.dart';
 import 'package:appwrite/models.dart' as models;
-import 'package:appwrite/permission.dart';
-import 'package:appwrite/role.dart';
 
 Client client = Client()
     .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint

diff --git a/docs/examples/vectorsdb/create-document.md b/docs/examples/vectorsdb/create-document.md
@@ -1,8 +1,6 @@
 ```dart
 import 'package:appwrite/appwrite.dart';
 import 'package:appwrite/models.dart' as models;
-import 'package:appwrite/permission.dart';
-import 'package:appwrite/role.dart';
 
 Client client = Client()
     .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint

diff --git a/docs/examples/vectorsdb/update-document.md b/docs/examples/vectorsdb/update-document.md
@@ -1,8 +1,6 @@
 ```dart
 import 'package:appwrite/appwrite.dart';
 import 'package:appwrite/models.dart' as models;
-import 'package:appwrite/permission.dart';
-import 'package:appwrite/role.dart';
 
 Client client = Client()
     .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint

diff --git a/docs/examples/vectorsdb/upsert-document.md b/docs/examples/vectorsdb/upsert-document.md
@@ -1,8 +1,6 @@
 ```dart
 import 'package:appwrite/appwrite.dart';
 import 'package:appwrite/models.dart' as models;
-import 'package:appwrite/permission.dart';
-import 'package:appwrite/role.dart';
 
 Client client = Client()
     .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint