appwrite 26.1.0 → 27.0.0

data/lib/appwrite/services/tables_db.rb

@@ -47,9 +47,10 @@ module Appwrite
         # @param [] enabled Is the database enabled? When set to 'disabled', users cannot access the database but Server SDKs with an API key can still read and write to the database. No data is lost when this is toggled.
         # @param [String] specification Database specification. Defaults to `serverless`, which creates the database on the shared pool. Any other value provisions a dedicated database on that specification.
         # @param [Integer] replicas Number of high availability replicas (0-5) for the dedicated database backing this database. Requires a dedicated `specification`; must be 0 for a serverless database. High availability is enabled when greater than 0.
+        # @param [String] sync_mode Replication sync mode for the dedicated database backing this database. Requires a dedicated `specification`; the mode is only in force once there is at least one replica. Allowed values: async, sync, quorum.
         #
         # @return [Database]
-        def create(database_id:, name:, enabled: nil, specification: nil, replicas: nil)
+        def create(database_id:, name:, enabled: nil, specification: nil, replicas: nil, sync_mode: nil)
             api_path = '/tablesdb'
 
             if database_id.nil?
@@ -66,6 +67,7 @@ module Appwrite
                 enabled: enabled,
                 specification: specification,
                 replicas: replicas,
+                syncMode: sync_mode,
             }
             
             api_headers = {
@@ -334,10 +336,12 @@ module Appwrite
         # @param [String] database_id Database ID.
         # @param [String] name Database name. Max length: 128 chars.
         # @param [] enabled Is database enabled? When set to 'disabled', users cannot access the database but Server SDKs with an API key can still read and write to the database. No data is lost when this is toggled.
+        # @param [String] specification Database specification. Resizing between dedicated specifications changes cpu, memory, storage and the connection ceiling via a rolling cutover with zero downtime. Moving a `serverless` database onto a dedicated specification is a data migration, not a resize.
         # @param [Integer] replicas Number of high availability replicas (0-5) for the dedicated database backing this database. Only valid when the database is backed by a dedicated specification. High availability is enabled when greater than 0.
+        # @param [String] sync_mode Replication sync mode for the dedicated database backing this database. Only valid when the database is backed by a dedicated specification; the mode is only in force once there is at least one replica. Allowed values: async, sync, quorum.
         #
         # @return [Database]
-        def update(database_id:, name: nil, enabled: nil, replicas: nil)
+        def update(database_id:, name: nil, enabled: nil, specification: nil, replicas: nil, sync_mode: nil)
             api_path = '/tablesdb/{databaseId}'
                 .gsub('{databaseId}', database_id)
 
@@ -348,7 +352,9 @@ module Appwrite
             api_params = {
                 name: name,
                 enabled: enabled,
+                specification: specification,
                 replicas: replicas,
+                syncMode: sync_mode,
             }
             
             api_headers = {
@@ -400,7 +406,9 @@ module Appwrite
 
         # Trigger a manual failover for a dedicated database with high availability
         # enabled. Promotes a replica to primary. The failover runs asynchronously;
-        # poll the database document for status updates.
+        # poll the database document for status updates. A database left
+        # mid-operation by a failover that did not finish also accepts this call as a
+        # repair, provided `targetReplicaId` names the member to promote.
         #
         # @param [String] database_id Database ID.
         # @param [String] target_replica_id Target replica ID to promote. If not specified, the healthiest replica is selected.
@@ -434,6 +442,238 @@ module Appwrite
 
         end
 
+        # List the dedicated migrations for a TablesDB database. A database has at
+        # most one in-flight migration.
+        #
+        # @param [String] database_id Database ID.
+        #
+        # @return [DatabaseMigrationList]
+        def list_migrations(database_id:)
+            api_path = '/tablesdb/{databaseId}/migrations'
+                .gsub('{databaseId}', database_id)
+
+            if database_id.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
+            end
+
+            api_params = {
+            }
+            
+            api_headers = {
+                "X-Appwrite-Project": @client.get_config('project'),
+                "accept": 'application/json',
+            }
+
+            @client.call(
+                method: 'GET',
+                path: api_path,
+                headers: api_headers,
+                params: api_params,
+                response_type: Models::DatabaseMigrationList
+            )
+
+        end
+
+        # Start migrating a serverless TablesDB database onto a dedicated MySQL
+        # compute. Data is copied to the target while the source stays live, with a
+        # brief read-only window during cutover.
+        #
+        # @param [String] database_id Database ID.
+        # @param [String] specification Dedicated compute specification to provision as the migration target (e.g. s-2vcpu-4gb). The migration always targets a dedicated compute, so `serverless` is not accepted.
+        # @param [] auto_cutover Whether to cut over automatically once the copy is verified. When disabled the migration parks at ready_to_cutover and holds there until the cutover is performed manually.
+        #
+        # @return [DatabaseMigration]
+        def create_migration(database_id:, specification:, auto_cutover: nil)
+            api_path = '/tablesdb/{databaseId}/migrations'
+                .gsub('{databaseId}', database_id)
+
+            if database_id.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
+            end
+
+            if specification.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "specification"')
+            end
+
+            api_params = {
+                specification: specification,
+                autoCutover: auto_cutover,
+            }
+            
+            api_headers = {
+                "X-Appwrite-Project": @client.get_config('project'),
+                "content-type": 'application/json',
+                "accept": 'application/json',
+            }
+
+            @client.call(
+                method: 'POST',
+                path: api_path,
+                headers: api_headers,
+                params: api_params,
+                response_type: Models::DatabaseMigration
+            )
+
+        end
+
+        # Get a single dedicated migration for a TablesDB database by its ID.
+        #
+        # @param [String] database_id Database ID.
+        # @param [String] migration_id Migration ID.
+        #
+        # @return [DatabaseMigration]
+        def get_migration(database_id:, migration_id:)
+            api_path = '/tablesdb/{databaseId}/migrations/{migrationId}'
+                .gsub('{databaseId}', database_id)
+                .gsub('{migrationId}', migration_id)
+
+            if database_id.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
+            end
+
+            if migration_id.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "migrationId"')
+            end
+
+            api_params = {
+            }
+            
+            api_headers = {
+                "X-Appwrite-Project": @client.get_config('project'),
+                "accept": 'application/json',
+            }
+
+            @client.call(
+                method: 'GET',
+                path: api_path,
+                headers: api_headers,
+                params: api_params,
+                response_type: Models::DatabaseMigration
+            )
+
+        end
+
+        # Abort an in-flight TablesDB dedicated migration. Only allowed before
+        # cutover; once the migration has cut over it cannot be aborted.
+        #
+        # @param [String] database_id Database ID.
+        # @param [String] migration_id Migration ID.
+        #
+        # @return []
+        def delete_migration(database_id:, migration_id:)
+            api_path = '/tablesdb/{databaseId}/migrations/{migrationId}'
+                .gsub('{databaseId}', database_id)
+                .gsub('{migrationId}', migration_id)
+
+            if database_id.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
+            end
+
+            if migration_id.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "migrationId"')
+            end
+
+            api_params = {
+            }
+            
+            api_headers = {
+                "X-Appwrite-Project": @client.get_config('project'),
+                "content-type": 'application/json',
+                "accept": 'application/json',
+            }
+
+            @client.call(
+                method: 'DELETE',
+                path: api_path,
+                headers: api_headers,
+                params: api_params,
+            )
+
+        end
+
+        # Cut a verified TablesDB migration over to its dedicated compute. Only
+        # applies to a migration created with `autoCutover` disabled, which waits at
+        # `ready_to_cutover` until this is called. The routing flip happens shortly
+        # after this returns, with a brief read-only window. One call buys one
+        # attempt: a cutover that fails a check returns the migration to `verifying`
+        # and parks it again, so call this once more to retry.
+        #
+        # @param [String] database_id Database ID.
+        # @param [String] migration_id Migration ID.
+        #
+        # @return [DatabaseMigration]
+        def cutover_migration(database_id:, migration_id:)
+            api_path = '/tablesdb/{databaseId}/migrations/{migrationId}/cutover'
+                .gsub('{databaseId}', database_id)
+                .gsub('{migrationId}', migration_id)
+
+            if database_id.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
+            end
+
+            if migration_id.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "migrationId"')
+            end
+
+            api_params = {
+            }
+            
+            api_headers = {
+                "X-Appwrite-Project": @client.get_config('project'),
+                "content-type": 'application/json',
+                "accept": 'application/json',
+            }
+
+            @client.call(
+                method: 'POST',
+                path: api_path,
+                headers: api_headers,
+                params: api_params,
+                response_type: Models::DatabaseMigration
+            )
+
+        end
+
+        # List the lifecycle operations recorded for a dedicated database, newest
+        # first. Every provision, update, restore, backup and replication action is
+        # recorded here with its outcome, including an attempt that was abandoned
+        # because another worker took over the database.
+        #
+        # @param [String] database_id Database ID.
+        # @param [String] status Filter by operation status.
+        # @param [Integer] limit Maximum number of operations to return.
+        # @param [Integer] offset Number of operations to skip.
+        #
+        # @return [DedicatedDatabaseOperationList]
+        def list_operations(database_id:, status: nil, limit: nil, offset: nil)
+            api_path = '/tablesdb/{databaseId}/operations'
+                .gsub('{databaseId}', database_id)
+
+            if database_id.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
+            end
+
+            api_params = {
+                status: status,
+                limit: limit,
+                offset: offset,
+            }
+            
+            api_headers = {
+                "X-Appwrite-Project": @client.get_config('project'),
+                "accept": 'application/json',
+            }
+
+            @client.call(
+                method: 'GET',
+                path: api_path,
+                headers: api_headers,
+                params: api_params,
+                response_type: Models::DedicatedDatabaseOperationList
+            )
+
+        end
+
         # Get high availability status for a dedicated database. Returns replica
         # statuses, replication lag, and sync mode.
         #
@@ -548,7 +788,7 @@ module Appwrite
         # @param [Array] permissions An array of permissions strings. By default, no user is granted with any permissions. [Learn more about permissions](https://appwrite.io/docs/permissions).
         # @param [] row_security Enables configuring permissions for individual rows. A user needs one of row or table level permissions to access a row. [Learn more about permissions](https://appwrite.io/docs/permissions).
         # @param [] enabled Is table enabled? When set to 'disabled', users cannot access the table but Server SDKs with and API key can still read and write to the table. No data is lost when this is toggled.
-        # @param [Array] columns Array of column definitions to create. Each column should contain: key (string), type (string: string, integer, float, boolean, datetime, relationship), size (integer, required for string type), required (boolean, optional), default (mixed, optional), array (boolean, optional), and type-specific options.
+        # @param [Array] columns Array of column definitions to create. Each column should contain: key (string), type (string: string, varchar, text, mediumtext, longtext, integer, bigint, double, boolean, datetime, point, linestring, polygon, email, url, ip, enum), size (integer, required for string and varchar types), required (boolean, optional), default (mixed, optional), array (boolean, optional), and type-specific options.
         # @param [Array] indexes Array of index definitions to create. Each index should contain: key (string), type (string: key, fulltext, unique, spatial), attributes (array of column keys), orders (array of ASC/DESC, optional), and lengths (array of integers, optional).
         #
         # @return [Table]
@@ -2276,11 +2516,11 @@ module Appwrite
         # @param [String] database_id Database ID.
         # @param [String] table_id Table ID.
         # @param [String] related_table_id Related Table ID.
-        # @param [RelationshipType] type Relation type
+        # @param [RelationshipType] type Relationship type. Possible values are: oneToOne, oneToMany, manyToOne, manyToMany.
         # @param [] two_way Is Two Way?
         # @param [String] key Column Key.
         # @param [String] two_way_key Two Way Column Key.
-        # @param [RelationMutate] on_delete Constraints option
+        # @param [RelationMutate] on_delete Delete constraint. Possible values are: cascade, restrict, setNull.
         #
         # @return [ColumnRelationship]
         def create_relationship_column(database_id:, table_id:, related_table_id:, type:, two_way: nil, key: nil, two_way_key: nil, on_delete: nil)
@@ -2964,7 +3204,7 @@ module Appwrite
         # @param [String] database_id Database ID.
         # @param [String] table_id Table ID.
         # @param [String] key Column Key.
-        # @param [RelationMutate] on_delete Constraints option
+        # @param [RelationMutate] on_delete Delete constraint. Possible values are: cascade, restrict, setNull.
         # @param [String] new_key New Column Key.
         #
         # @return [ColumnRelationship]

data/lib/appwrite/services/users.rb

@@ -908,6 +908,44 @@ module Appwrite
 
         end
 
+        # Get a custom MFA challenge for a user, including the code to be delivered
+        # through your own channel.
+        #
+        # @param [String] user_id User ID.
+        # @param [String] challenge_id ID of the challenge.
+        #
+        # @return [MfaChallengeSecret]
+        def get_mfa_challenge(user_id:, challenge_id:)
+            api_path = '/users/{userId}/mfa/challenges/{challengeId}'
+                .gsub('{userId}', user_id)
+                .gsub('{challengeId}', challenge_id)
+
+            if user_id.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "userId"')
+            end
+
+            if challenge_id.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "challengeId"')
+            end
+
+            api_params = {
+            }
+            
+            api_headers = {
+                "X-Appwrite-Project": @client.get_config('project'),
+                "accept": 'application/json',
+            }
+
+            @client.call(
+                method: 'GET',
+                path: api_path,
+                headers: api_headers,
+                params: api_params,
+                response_type: Models::MfaChallengeSecret
+            )
+
+        end
+
         # List the factors available on the account to be used as a MFA challange.
         #
         # @param [String] user_id User ID.

data/lib/appwrite.rb

@@ -57,9 +57,11 @@ require_relative 'appwrite/models/subscriber_list'
 require_relative 'appwrite/models/target_list'
 require_relative 'appwrite/models/transaction_list'
 require_relative 'appwrite/models/specification_list'
+require_relative 'appwrite/models/embedding_list'
 require_relative 'appwrite/models/insight_list'
 require_relative 'appwrite/models/report_list'
 require_relative 'appwrite/models/database'
+require_relative 'appwrite/models/embedding'
 require_relative 'appwrite/models/collection'
 require_relative 'appwrite/models/attribute_list'
 require_relative 'appwrite/models/attribute_string'
@@ -194,6 +196,7 @@ require_relative 'appwrite/models/policy_session_invalidation'
 require_relative 'appwrite/models/policy_session_limit'
 require_relative 'appwrite/models/policy_user_limit'
 require_relative 'appwrite/models/policy_membership_privacy'
+require_relative 'appwrite/models/policy_mfa_factors'
 require_relative 'appwrite/models/platform_web'
 require_relative 'appwrite/models/platform_apple'
 require_relative 'appwrite/models/platform_android'
@@ -211,6 +214,7 @@ require_relative 'appwrite/models/specification'
 require_relative 'appwrite/models/proxy_rule'
 require_relative 'appwrite/models/email_template'
 require_relative 'appwrite/models/mfa_challenge'
+require_relative 'appwrite/models/mfa_challenge_secret'
 require_relative 'appwrite/models/mfa_recovery_codes'
 require_relative 'appwrite/models/mfa_type'
 require_relative 'appwrite/models/mfa_factors'
@@ -234,10 +238,14 @@ require_relative 'appwrite/models/billing_plan_limits'
 require_relative 'appwrite/models/billing_plan_dedicated_database_limits'
 require_relative 'appwrite/models/billing_plan_supported_addons'
 require_relative 'appwrite/models/block'
+require_relative 'appwrite/models/database_migration'
 require_relative 'appwrite/models/dedicated_database'
 require_relative 'appwrite/models/database_status'
 require_relative 'appwrite/models/dedicated_database_member'
+require_relative 'appwrite/models/dedicated_database_operation'
+require_relative 'appwrite/models/dedicated_database_operation_list'
 require_relative 'appwrite/models/dedicated_database_replicas'
+require_relative 'appwrite/models/proxy_invalidation'
 require_relative 'appwrite/models/organization'
 require_relative 'appwrite/models/backup_policy'
 require_relative 'appwrite/models/policy_deny_aliased_email'
@@ -278,6 +286,7 @@ require_relative 'appwrite/models/activity_event_list'
 require_relative 'appwrite/models/backup_archive_list'
 require_relative 'appwrite/models/backup_policy_list'
 require_relative 'appwrite/models/backup_restoration_list'
+require_relative 'appwrite/models/database_migration_list'
 require_relative 'appwrite/models/apps_list'
 require_relative 'appwrite/models/app_secret_list'
 require_relative 'appwrite/models/app_scope_list'
@@ -299,6 +308,7 @@ require_relative 'appwrite/enums/relationship_type'
 require_relative 'appwrite/enums/relation_mutate'
 require_relative 'appwrite/enums/databases_index_type'
 require_relative 'appwrite/enums/order_by'
+require_relative 'appwrite/enums/embedding_model'
 require_relative 'appwrite/enums/runtime'
 require_relative 'appwrite/enums/project_key_scopes'
 require_relative 'appwrite/enums/template_reference_type'
@@ -319,6 +329,7 @@ require_relative 'appwrite/enums/project_service_id'
 require_relative 'appwrite/enums/project_smtp_secure'
 require_relative 'appwrite/enums/project_email_template_id'
 require_relative 'appwrite/enums/project_email_template_locale'
+require_relative 'appwrite/enums/invalidation_type'
 require_relative 'appwrite/enums/status_code'
 require_relative 'appwrite/enums/proxy_resource_type'
 require_relative 'appwrite/enums/framework'
@@ -351,6 +362,7 @@ require_relative 'appwrite/services/apps'
 require_relative 'appwrite/services/avatars'
 require_relative 'appwrite/services/backups'
 require_relative 'appwrite/services/databases'
+require_relative 'appwrite/services/embeddings'
 require_relative 'appwrite/services/functions'
 require_relative 'appwrite/services/graphql'
 require_relative 'appwrite/services/locale'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: appwrite
 version: !ruby/object:Gem::Version
-  version: 26.1.0
+  version: 27.0.0
 platform: ruby
 authors:
 - Appwrite Team
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-07-24 00:00:00.000000000 Z
+date: 2026-08-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: mime-types
@@ -50,6 +50,7 @@ files:
 - lib/appwrite/enums/databases_index_type.rb
 - lib/appwrite/enums/deployment_download_type.rb
 - lib/appwrite/enums/deployment_status.rb
+- lib/appwrite/enums/embedding_model.rb
 - lib/appwrite/enums/execution_method.rb
 - lib/appwrite/enums/execution_status.rb
 - lib/appwrite/enums/execution_trigger.rb
@@ -58,6 +59,7 @@ files:
 - lib/appwrite/enums/image_format.rb
 - lib/appwrite/enums/image_gravity.rb
 - lib/appwrite/enums/index_status.rb
+- lib/appwrite/enums/invalidation_type.rb
 - lib/appwrite/enums/message_priority.rb
 - lib/appwrite/enums/message_status.rb
 - lib/appwrite/enums/messaging_provider_type.rb
@@ -182,12 +184,16 @@ files:
 - lib/appwrite/models/currency_list.rb
 - lib/appwrite/models/database.rb
 - lib/appwrite/models/database_list.rb
+- lib/appwrite/models/database_migration.rb
+- lib/appwrite/models/database_migration_list.rb
 - lib/appwrite/models/database_status.rb
 - lib/appwrite/models/database_status_connections.rb
 - lib/appwrite/models/database_status_replica.rb
 - lib/appwrite/models/database_status_volume.rb
 - lib/appwrite/models/dedicated_database.rb
 - lib/appwrite/models/dedicated_database_member.rb
+- lib/appwrite/models/dedicated_database_operation.rb
+- lib/appwrite/models/dedicated_database_operation_list.rb
 - lib/appwrite/models/dedicated_database_replicas.rb
 - lib/appwrite/models/dedicated_database_specification.rb
 - lib/appwrite/models/dedicated_database_specification_list.rb
@@ -199,6 +205,8 @@ files:
 - lib/appwrite/models/document_list.rb
 - lib/appwrite/models/email_template.rb
 - lib/appwrite/models/email_template_list.rb
+- lib/appwrite/models/embedding.rb
+- lib/appwrite/models/embedding_list.rb
 - lib/appwrite/models/ephemeral_key.rb
 - lib/appwrite/models/execution.rb
 - lib/appwrite/models/execution_list.rb
@@ -232,6 +240,7 @@ files:
 - lib/appwrite/models/message.rb
 - lib/appwrite/models/message_list.rb
 - lib/appwrite/models/mfa_challenge.rb
+- lib/appwrite/models/mfa_challenge_secret.rb
 - lib/appwrite/models/mfa_factors.rb
 - lib/appwrite/models/mfa_recovery_codes.rb
 - lib/appwrite/models/mfa_type.rb
@@ -309,6 +318,7 @@ files:
 - lib/appwrite/models/policy_deny_free_email.rb
 - lib/appwrite/models/policy_list.rb
 - lib/appwrite/models/policy_membership_privacy.rb
+- lib/appwrite/models/policy_mfa_factors.rb
 - lib/appwrite/models/policy_password_dictionary.rb
 - lib/appwrite/models/policy_password_history.rb
 - lib/appwrite/models/policy_password_personal_data.rb
@@ -329,6 +339,7 @@ files:
 - lib/appwrite/models/project_service.rb
 - lib/appwrite/models/provider.rb
 - lib/appwrite/models/provider_list.rb
+- lib/appwrite/models/proxy_invalidation.rb
 - lib/appwrite/models/proxy_rule.rb
 - lib/appwrite/models/proxy_rule_list.rb
 - lib/appwrite/models/report.rb
@@ -377,6 +388,7 @@ files:
 - lib/appwrite/services/avatars.rb
 - lib/appwrite/services/backups.rb
 - lib/appwrite/services/databases.rb
+- lib/appwrite/services/embeddings.rb
 - lib/appwrite/services/functions.rb
 - lib/appwrite/services/graphql.rb
 - lib/appwrite/services/locale.rb