27.2.0

What's Changed

• Updated: project.list_environments, project.create_environment, project.get_environment, project.update_environment return Environment models instead of Project
• Added: account.create_device, account.get_device, account.delete_device and account.update_device_session, and the Device model
• Added: project.update_account_devices_policy, ProjectPolicyId.ACCOUNT_DEVICES and the PolicyAccountDevices model
• Added: project.update_o_auth2_vipps, project.update_o_auth2_vipps_sandbox and the OAuth2Vipps model
• Added: OAuthProvider.VIPPS and OAuthProvider.VIPPSSANDBOX
• Added: proxy.update_function_rule, proxy.update_redirect_rule and proxy.update_site_rule
• Added: optional schedule on waf rule create and update methods and on WafRule* models
• Added: project.get_prefs and project.update_prefs for project preferences
• Added: Client.set_environment to act in a project environment
• Added: AppwriteMigrationResource.PROJECT_PREFERENCES to migrate project preferences
• Added: monitors.read, monitors.write, alerts.read, alerts.write, reviews.read and reviews.write to ProjectKeyScopes
• Added: Organization.budgetnotify, budgetcritical and educationexpiresat
• Added: Project.environmentid, Session.username and ActivityEvent.reason
• Added: ProxyRule.expireat and certificatestatus
• Updated: requests send response format 2.7.1; README targets Appwrite 2.7.x

Full Changelog: 27.1.0...27.2.0

27.1.0

What's Changed

• Added: migrations service to run Appwrite, Firebase, NHost, Supabase, CSV and JSON migrations, plus retries and listing
• Added: Migration, MigrationList and MigrationReport models and the AppwriteMigrationResource, FirebaseMigrationResource, NHostMigrationResource, SupabaseMigrationResource and OnDuplicate enums
• Added: project.update_deny_realtime_guests_policy, the PolicyDenyRealtimeGuests model and ProjectPolicyId.DENY_REALTIME_GUESTS
• Added: project.delete_sessions to sign out every user in the project
• Added: BillingPlan.deploymentretention, deploymentretentionmax and deploymentsretentioncount
• Added: python-3.15, deno-2.9, go-1.27 and rust-1.99 to Runtime and BuildRuntime
• Updated: requests send X-Appwrite-Response-Format: 2.6.2; README targets Appwrite 2.6.x
• Updated: redirects are no longer followed; a 3xx raises AppwriteException naming the Location
• Fixed: path parameters are percent-encoded as one segment; . and .. raise AppwriteException
• Fixed: the chunked-upload resume lookup encodes the file ID

Full Changelog: 27.0.0...27.1.0

27.0.0

27.0.0

This release updates the HTTP dependency requirements and raises the minimum supported Python version.

• Breaking: Python 3.9 is no longer supported. Upgrade to Python 3.10 or later before installing this release.
• Security: required requests>=2.34.2,<3 and urllib3>=2.8.0,<3 to exclude older dependency versions with known advisories. Update application dependency pins or constraints that prevent these versions from being installed.
• Compatibility: service methods, models, and response format 2.5.0 are unchanged from SDK 26.0.0. The SDK continues to target Appwrite 2.5.x.

To upgrade, activate a Python 3.10+ environment and run:

python -m pip install --upgrade "appwrite==27.0.0"

Full Changelog: 26.0.0...27.0.0

26.0.0

What's Changed

• Breaking: tables_db, documents_db and vectors_db create and update take description before specification
• Breaking: functions.update takes description before email_enabled
• Added: create_query on databases, documents_db and tables_db to send list queries in the request body
• Added: account.list_memberships
• Added: optional description on create and update for databases, collections, tables, attributes, columns, indexes, buckets, functions, sites, variables, topics, webhooks and keys
• Added: description on the matching models
• Added: total on list methods in activities, backups, domains, mongo, mysql and postgresql
• Added: emails on messaging.create_email and messaging.update_email
• Added: deny_list on project.update_password_dictionary_policy, update_password_personal_data_policy and their policy models
• Added: BillingPlan.functions_allow_cron
• Added: strip_metadata on storage.create_bucket, update_bucket and the Bucket model
• Updated: package classifiers list Python 3.13

Full Changelog: 25.0.0...26.0.0

25.0.0

What's Changed

• Breaking: requests send X-Appwrite-Response-Format: 2.5.0; responses follow the 2.5 shapes
• Breaking: removed account.list_logs, users.list_logs and the Log/LogList models
• Breaking: removed organization.create_key, get_key, list_keys, update_key and delete_key, and OrganizationKeyScopes; use organization.list_project_keys, get_project_key, update_project_key and delete_project_key instead
• Breaking: removed Client.set_dev_key, the DevKey model and Project.dev_keys
• Breaking: removed BillingPlanGroup.STARTER; use BillingPlanGroup.FREE
• Breaking: list_specifications returns each specification's prices and overage rates on the row itself. Removed the list-level pricing field and the DedicatedDatabaseSpecificationPricing model
• Breaking: removed Block fields reason, project_name, region, organization_name, organization_id and billing_plan
• Breaking: OAuth2 resource params now take List[str]
• Breaking: project.update_o_auth2_kakao takes enabled before prompt
• Breaking: BackupRestoration.options is now a dict
• Breaking: some response fields became Optional, such as BillingPlan.usage and DedicatedDatabase.engine
• Added: Topic helper to build MQTT topics for push messages
• Added: mongo, mysql and postgresql promote_restoration, restore_mode, target_name and auto_promote on create_restoration, and DedicatedDatabaseRestoration.restore_mode
• Added: proxy.create_smtp_rule, the ProxyRuleProtocol enum and ProxyRule.protocol
• Added: email_enabled on functions.update and Function, and ExecutionTrigger.EMAIL
• Added: Query aggregates (count, count_distinct, sum, avg, min, max and more), group_by, having, distinct, joins, relationship, covers, spatial_equals and page
• Added: Query.builder() to chain queries; build() returns the query list
• Updated: missing response fields fall back to their documented defaults
• Fixed: map fields missing from a response default to {} instead of []

24.4.0

What's Changed

• Added: domains service to manage domains, DNS records, email presets, prices, transfer status and zones
• Added: waf service with bypass, challenge, deny, rate-limit and redirect rules
• Added: account.createEmailVerificationOTP, updateEmailVerificationOTP, createRecoveryOTP and updateRecoveryOTP
• Added: account.createIdTokenSession and Identity.providerIdToken
• Added: oauth2.introspect
• Added: project environments with project.createEnvironment, getEnvironment, listEnvironments, updateEnvironment and deleteEnvironment
• Added: organization.createEphemeralProjectKey, listProjectKeys, getProjectKey, updateProjectKey and deleteProjectKey
• Added: Kakao, TikTok and Webflow OAuth2 providers with project.updateOAuth2Kakao, updateOAuth2TikTok and updateOAuth2Webflow
• Added: optional prompt on the Auth0, Discord, GitHub, Microsoft, Okta, Salesforce and Zoho OAuth2 settings, and native client IDs on Apple and Google
• Added: project.updatePasswordPwnedPolicy, project.updatePasswordRotationPolicy and User.passwordPwned
• Added: messaging.createAppwriteProvider and messaging.updateAppwriteProvider
• Added: optional replyToEmail and replyToName on email messages, channelId on push messages, and qos and expiry on topics
• Added: avatars.updatePhoto and avatars.deletePhoto
• Added: optional duration on account.createEmailPasswordSession, current on account.deleteSessions, membershipId on teams.createMembership and fingerprints on Android platforms
• Added: optional total on the locale, transaction, runtime, specification and framework lists
• Added: dart-3.13 and flutter-3.47 runtimes, the jaspr framework, the trigram index type, auto image gravity, the dedicatedDatabase proxy rule resource type, OTP email templates and new key scopes
• Added: optional fields on BillingPlan, DedicatedDatabase, DedicatedDatabaseSpecification, Project and Topic, and free and start in BillingPlanGroup

Full Changelog: 24.3.1...24.4.0

24.3.1

What's Changed

• Fixed: added ProjectAuthMethodId.PASSKEY, so project.updateAuthMethod can enable passkeys
• Fixed: added ProjectPolicyId.PASSKEY and the PolicyPasskey model, so getPolicy and listPolicies return the passkey policy

Full Changelog: 24.3.0...24.3.1

24.3.0

What's Changed

• Added: account passkey methods listPasskeys, createPasskey, getPasskey, updatePasskey, deletePasskey and updatePasskeyVerification
• Added: account.createPasskeyToken and account.updatePasskeyToken for passkey sign-in
• Added: users.listPasskeys, users.getPasskey, users.updatePasskey and users.deletePasskey
• Added: project.updatePasskeyPolicy to configure passkey sign-in
• Added: Passkey, PasskeyList, PasskeyChallenge and TokenSecret models

Full Changelog: 24.2.0...24.3.0

24.2.0

What's Changed

• Added: optional interval parameter on functions.create and functions.update to run a function every N minutes
• Added: interval on the Function model and functionsIntervalMinimum on the BillingPlan model

Full Changelog: 24.1.0...24.2.0

24.1.0

What's Changed

• Added: optional state parameter on createOAuth2Token, returned unchanged on the success and failure URLs

Full Changelog: 24.0.0...24.1.0