appwrite · ChiragAgg5k · Jul 13, 2026 · Jul 13, 2026 · Jul 13, 2026 · Jul 13, 2026
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,23 @@
 # Change Log
 
+## 26.0.0
+
+* Breaking: Removed `Health` service and all health models and enums
+* Breaking: Removed `Usage` service and `UsageEvent`/`UsageGauge` models
+* Breaking: Removed `Messaging` log methods `list_message_logs`, `list_provider_logs`, `list_subscriber_logs`, `list_topic_logs`
+* Breaking: Removed OS, client, and device fields plus `countryCode`/`countryName` from `ActivityEvent` (`country` remains)
+* Added: `Client#set_bearer` for OAuth access token authentication
+* Added: `Organization` `get`, `update`, `delete`, and membership CRUD methods
+* Added: `Query.vector_dot`, `Query.vector_cosine`, `Query.vector_euclidean` query helpers
+* Added: `Project#update_o_auth2_appwrite` and `Project#update_deny_corporate_email_policy` methods
+* Added: OAuth2 server device-flow params (`verification_url`, `user_code_length`, `device_code_duration`, `default_scopes`)
+* Added: optional params `new_specification` (restorations), `token` (deployment download), `type` (list specifications), `specification` (TablesDB create)
+* Added: `Organization`, `BillingPlan`, `AdditionalResource`, `Program`, `OAuth2Appwrite`, `PolicyDenyCorporateEmail` models
+* Added: `DatabaseStatus`, `BillingPlanGroup`, `ProjectOAuth2OidcPrompt` enums and `APPWRITE` OAuth provider
+* Added: `Locale` geolocation/ISP fields, `Membership#user_accessed_at`, `Block#mode`, `BackupPolicy#type`, `Database#status`
+* Added: `User` email classification fields (`email_is_free`, `email_is_disposable`, `email_is_corporate`)
+* Added: new key scopes (`stages.*`, `project.oauth2.*`, `organization.*`, `dedicatedDatabases.execute`)
+
 ## 25.1.0
 
 * Added: `createSesProvider` and `updateSesProvider` to `messaging`

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

diff --git a/docs/examples/account/create.md b/docs/examples/account/create.md
@@ -13,7 +13,7 @@ account = Account.new(client)
 result = account.create(
     user_id: '<USER_ID>',
     email: 'email@example.com',
-    password: '',
+    password: 'password',
     name: '<NAME>' # optional
 )
 ```
diff --git a/docs/examples/account/update-password.md b/docs/examples/account/update-password.md
@@ -11,7 +11,7 @@ client = Client.new
 account = Account.new(client)
 
 result = account.update_password(
-    password: '',
-    old_password: '<OLD_PASSWORD>' # optional
+    password: 'password',
+    old_password: 'password' # optional
 )
 ```
diff --git a/docs/examples/account/update-recovery.md b/docs/examples/account/update-recovery.md
@@ -13,6 +13,6 @@ account = Account.new(client)
 result = account.update_recovery(
     user_id: '<USER_ID>',
     secret: '<SECRET>',
-    password: ''
+    password: 'password'
 )
 ```
diff --git a/docs/examples/backups/create-restoration.md b/docs/examples/backups/create-restoration.md
@@ -15,6 +15,7 @@ result = backups.create_restoration(
     archive_id: '<ARCHIVE_ID>',
     services: [BackupServices::DATABASES],
     new_resource_id: '<NEW_RESOURCE_ID>', # optional
-    new_resource_name: '<NEW_RESOURCE_NAME>' # optional
+    new_resource_name: '<NEW_RESOURCE_NAME>', # optional
+    new_specification: 'serverless' # optional
 )
 ```
diff --git a/docs/examples/functions/get-deployment-download.md b/docs/examples/functions/get-deployment-download.md
@@ -14,6 +14,7 @@ functions = Functions.new(client)
 result = functions.get_deployment_download(
     function_id: '<FUNCTION_ID>',
     deployment_id: '<DEPLOYMENT_ID>',
-    type: DeploymentDownloadType::SOURCE # optional
+    type: DeploymentDownloadType::SOURCE, # optional
+    token: '<TOKEN>' # optional
 )
 ```
diff --git a/docs/examples/functions/list-specifications.md b/docs/examples/functions/list-specifications.md
@@ -10,5 +10,7 @@ client = Client.new
 
 functions = Functions.new(client)
 
-result = functions.list_specifications()
+result = functions.list_specifications(
+    type: 'runtimes' # optional
+)
 ```
diff --git a/docs/examples/health/get-audits-db.md b/docs/examples/health/get-audits-db.md
diff --git a/docs/examples/health/get-cache.md b/docs/examples/health/get-cache.md
diff --git a/docs/examples/health/get-db.md b/docs/examples/health/get-db.md
diff --git a/docs/examples/health/get-failed-jobs.md b/docs/examples/health/get-failed-jobs.md
diff --git a/docs/examples/health/get-pub-sub.md b/docs/examples/health/get-pub-sub.md
diff --git a/docs/examples/health/get-queue-databases.md b/docs/examples/health/get-queue-databases.md
diff --git a/docs/examples/health/get-queue-deletes.md b/docs/examples/health/get-queue-deletes.md
diff --git a/docs/examples/health/get-queue-functions.md b/docs/examples/health/get-queue-functions.md
diff --git a/docs/examples/health/get-queue-logs.md b/docs/examples/health/get-queue-logs.md
diff --git a/docs/examples/health/get-queue-mails.md b/docs/examples/health/get-queue-mails.md
diff --git a/docs/examples/health/get-queue-messaging.md b/docs/examples/health/get-queue-messaging.md
diff --git a/docs/examples/health/get-queue-migrations.md b/docs/examples/health/get-queue-migrations.md
diff --git a/docs/examples/health/get-queue-stats-resources.md b/docs/examples/health/get-queue-stats-resources.md
diff --git a/docs/examples/health/get-queue-usage.md b/docs/examples/health/get-queue-usage.md
diff --git a/docs/examples/health/get-queue-webhooks.md b/docs/examples/health/get-queue-webhooks.md
diff --git a/docs/examples/health/get-storage-local.md b/docs/examples/health/get-storage-local.md
diff --git a/docs/examples/health/get-storage.md b/docs/examples/health/get-storage.md
diff --git a/docs/examples/health/get-time.md b/docs/examples/health/get-time.md
diff --git a/docs/examples/messaging/create-smtp-provider.md b/docs/examples/messaging/create-smtp-provider.md
@@ -17,7 +17,7 @@ result = messaging.create_smtp_provider(
     host: '<HOST>',
     port: 1, # optional
     username: '<USERNAME>', # optional
-    password: '<PASSWORD>', # optional
+    password: 'password', # optional
     encryption: SmtpEncryption::NONE, # optional
     auto_tls: false, # optional
     mailer: '<MAILER>', # optional