28.0.0

What's Changed

• Stable release of the dedicated database APIs: mysql, postgresql, mongo, documentsDB, and vectorsDB services, previously released as release candidates
• Breaking: tablesDB.cutoverMigration is renamed to tablesDB.createCutover
• Breaking: Execution.functionId is replaced by resourceId and resourceType, covering function and site executions
• Breaking: mysql.updateCredentials, postgresql.updateCredentials, and mongo.updateCredentials now return DedicatedDatabaseOperation; poll the operation to a terminal status, then fetch the database for the refreshed credentials
• Added: Cloudflare, Resend, and Hugging Face OAuth providers
• Added: usageAggregateOnlyMetrics on the BillingPlan model
• Added: credentialGeneration on the DedicatedDatabase model
• Added: documentsdb.indexes.read, documentsdb.indexes.write, vectorsdb.indexes.read, and vectorsdb.indexes.write to ProjectKeyScopes
• Fixed: transactionId is accepted again by documentsDB and vectorsDB createDocument and createDocuments
• Updated: X-Appwrite-Response-Format is now 2.0.0

Full Changelog: 27.0.0...28.0.0

28.0.0.rc1

What's Changed

• Breaking: Execution.functionId is replaced by resourceId and resourceType, now that executions cover both functions and sites
• Breaking: removed dedicatedDatabases.execute from ProjectKeyScopes
• Breaking: EmbeddingModel no longer offers embedding-gemma or bge-small
• Added: documentsDB, vectorsDB, mysql, postgresql, and mongo services, no longer hidden from server SDKs
• Added: DocumentsDBIndexType and VectorsDBIndexType enums
• Added: dedicated database models for branches, backups, restorations, poolers, PITR windows, extensions, and executions
• Added: PostgresExtension, VectorsdbCollection, AttributeObject, and AttributeVector models
• Added: ExecutionResourceType enum and resourceType on the Execution model
• Added: OAuth2HuggingFace model and the huggingface OAuth provider
• Added: userId, emailHash, and name parameters to avatars.getPhoto
• Added: error, containerStatus, and lifecycleState on the Database model
• Added: changelogWatermark on the DatabaseMigration model
• Added: total on the DedicatedDatabaseBranchList model
• Updated: DedicatedDatabaseOperation.status documents the new queued state

Full Changelog: 27.0.0...28.0.0.rc1

27.0.0

What's Changed

• Breaking: removed account.createJWT; use users.createJWT instead. A leaked JWT could mint further JWTs, letting a credential outlive its own expiry — a session cannot duplicate itself to live forever either
• Breaking: removed project.createKey. A leaked key could mint further hidden keys, making a compromise far harder to contain and revoke
• Breaking: activities.listEvents queries now takes an array instead of a string
• Added: embeddings service with createTextEmbeddings, plus the EmbeddingModel enum
• Added: TablesDB migration methods listMigrations, createMigration, getMigration, deleteMigration, cutoverMigration, and listOperations
• Added: proxy.createInvalidation for purging cached edge responses, plus the InvalidationType enum
• Added: apps.deleteInstallation
• Added: users.getMFAChallenge and the MfaChallengeSecret model
• Added: project.updateMFAFactorsPolicy and the PolicyMfaFactors model
• Added: client.setOrganization for organization-scoped requests
• Added: folder parameter to storage.createFile
• Added: syncMode parameter to tablesDB.create and tablesDB.update, and specification to tablesDB.update
• Added: installationScopes parameter to project.updateOAuth2Server
• Added: custom authentication factor, node-26 runtime, mfa-factors project policy, and the embeddings.write and proxy.invalidations.write key scopes
• Updated: response format to 1.9.6

Full Changelog: 26.1.0...27.0.0

26.1.0

What's Changed

• Added: Apps service for managing OAuth2 applications, keys, and installations
• Added: OAuth2 service with authorize, grant, device authorization, and consent flows
• Added: account OAuth2 consent methods list_consents, get_consent, delete_consent, and consent token methods
• Added: app installation management methods to Organization and Teams services
• Added: installation_access_token_duration parameter to project.update_o_auth2_server
• Added: token parameter to sites.get_deployment_download
• Added: oauth2.introspect and organization installation key scopes

Full Changelog: 26.0.0...26.1.0

26.0.0

What's Changed

• 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)

Full Changelog: 25.1.0...26.0.0

25.1.0

What's Changed

• Added: createSesProvider and updateSesProvider to messaging
• Added: updateOAuth2Server to project for OAuth2 server settings
• Added: updatePasswordStrengthPolicy and PolicyPasswordStrength to project
• Added: getAuditsDB health check to health
• Added: password-strength to ProjectPolicyId
• Added: apps.read and apps.write to ProjectKeyScopes

Full Changelog: 25.0.0...25.1.0

25.0.0

What's Changed

• Breaking: Removed githubImagine and googleImagine from ProjectOAuthProviderId
• Breaking: Removed deno-1.21, deno-1.24, and deno-1.35 from Runtime and BuildRuntime
• Breaking: Dropped numeric suffixes from StatusCode redirect members
• Added: Organization service for managing projects and API keys
• Added: PolicyDenyAliasedEmail, PolicyDenyDisposableEmail, and PolicyDenyFreeEmail policy models
• Added: deny-aliased-email, deny-disposable-email, and deny-free-email to ProjectPolicyId
• Replaced: BrowserTheme, HealthQueueName, OrganizationKeyScopes, and Region enums
• Added: dart-3.12 and flutter-3.44 runtimes
• Added: ProjectList model and new attributes on Function, Site, and UsageGauge
• Updated: functions, sites, usage, health, and avatars services
• Updated: Renamed updatePresence to update in the presences service

Full Changelog: 24.2.0...25.0.0

24.2.0

What's Changed

• feat: support concurrent chunk uploads by @TorstenDittmann in #63
• chore: bump SDK version to 24.2.0 by @TorstenDittmann in #64

Full Changelog: 24.1.0...24.2.0

24.1.0

What's Changed

• Added size_actual attribute to File model
• Added DENO_1_21, DENO_1_24, and DENO_1_35 runtime constants
• Updated advisor examples to use API key authentication

Full Changelog: 24.0.0...24.1.0

24.0.0

What's Changed

• Breaking: Renamed AuthMethod enum to ProjectAuthMethodId
• Breaking: Renamed EmailTemplateType to ProjectEmailTemplateId and EmailTemplateLocale to ProjectEmailTemplateLocale
• Breaking: Renamed ServiceId to ProjectServiceId, ProtocolId to ProjectProtocolId, Secure to ProjectSMTPSecure, ProjectPolicy to ProjectPolicyId
• Breaking: Replaced Scopes enum with ProjectKeyScopes for project key endpoints
• Breaking: Removed Project#update_deny_canonical_email_policy; replaced with update_deny_aliased_email_policy, update_deny_disposable_email_policy, and update_deny_free_email_policy
• Breaking: Removed AuthProvider model; use new ProjectOAuthProviderId enum instead
• Added: Project#get method to fetch current project details
• Added: Advisor, Presences, and Usage services
• Added: Insight, Presence, Report, UsageEvent, and UsageGauge models with list variants
• Added: ProjectAuthMethod, ProjectProtocol, and ProjectService models
• Added: ProjectOAuthProviderId and ProjectOAuth2GooglePrompt enums
• Updated: Project, Database, and OAuth2Google model schemas
• Updated: X-Appwrite-Response-Format header to 1.9.5

Full Changelog: 23.1.0...24.0.0