20.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: 19.2.0...20.0.0

19.2.0

What's Changed

• feat: support concurrent chunk uploads by @TorstenDittmann in #145
• chore: bump SDK version to 19.2.0 by @TorstenDittmann in #146

Full Changelog: 19.1.0...19.2.0

19.1.0

What's Changed

• Added DENO_1_21, DENO_1_24, and DENO_1_35 runtime options
• Added sizeactual field to File model for compressed file size
• Updated BillingLimits model fields to be optional
• Updated Project model billinglimits field to be optional
• Updated authentication examples in advisor documentation

Full Changelog: 19.0.0...19.1.0

19.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 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: 18.1.0...19.0.0

18.1.0

What's Changed

• Added: Introduced bigint create/update APIs for legacy Databases attributes
• Added: Introduced bigint create/update APIs for TablesDB columns
• Updated: Extended key-list query filters with key, resourceType, resourceId, and secret

Full Changelog: 18.0.0...18.1.0

18.0.0

What's Changed

• [BREAKING] Renamed Webhook model fields: security → tls, httpUser → authUsername, httpPass → authPassword, signatureKey → secret
• [BREAKING] Renamed Webhook service parameters to match: security → tls, httpUser → authUsername, httpPass → authPassword
• [BREAKING] Renamed Webhooks.update_signature() to Webhooks.update_secret() with new optional secret parameter
• Added Client.get_headers() method to retrieve request headers
• Added secret parameter to Webhook create and update methods
• Added x OAuth provider to OAuthProvider enum
• Added userType field to Log model
• Added purge parameter to update_collection and update_table for cache invalidation
• Added Project service: platform CRUD, key CRUD, protocol/service status management
• Added new models: Key, KeyList, Project, DevKey, MockNumber, AuthProvider, PlatformAndroid, PlatformApple, PlatformLinux, PlatformList, PlatformWeb, PlatformWindows, BillingLimits, Block
• Added new enums: PlatformType, ProtocolId, ServiceId
• Updated BuildRuntime, Runtime enums with dart-3.11 and flutter-3.41
• Updated Scopes enum with keys_read, keys_write, platforms_read, platforms_write
• Updated X-Appwrite-Response-Format header to 1.9.1
• Updated TTL description for list caching in Databases and TablesDB
• Simplified _parse_response() by removing union_models parameter

Full Changelog: 17.0.0...18.0.0

17.0.0

What's Changed

• [BREAKING] Changed $sequence type from float to str for Row and Document models
• [BREAKING] Renamed IndexType enum: split into DatabasesIndexType (with new SPATIAL value) and TablesDBIndexType
• [BREAKING] Replaced specification parameter with build_specification and runtime_specification in functions.create(), functions.update(), sites.create(), sites.update()
• Added new Project service with full CRUD for project-level environment variables
• Added new Webhooks service with full CRUD for project webhooks (including update_signature)
• Added Webhook and WebhookList models
• Added users.update_impersonator() method for enabling/disabling user impersonation
• Added impersonation support: set_impersonate_user_id(), set_impersonate_user_email(), set_impersonate_user_phone() on Client
• Added impersonator and impersonatoruserid optional fields to User model
• Added deployment_retention parameter to Functions and Sites create/update
• Added start_command parameter to Sites create/update
• Added Documentsdb, Vectorsdb values to BackupServices and DatabaseType enums
• Added WebhooksRead, WebhooksWrite, ProjectRead, ProjectWrite scopes
• Removed get_queue_billing_project_aggregation, get_queue_billing_team_aggregation, get_queue_priority_builds, get_queue_region_manager, get_queue_threats from Health service
• Updated Log model field descriptions to clarify impersonation behavior
• Updated X-Appwrite-Response-Format header to 1.9.0

Full Changelog: 16.0.0...17.0.0

16.0.0

What's Changed

• Breaking change: All service methods now return typed Pydantic models instead of Dict[str, Any]
• Breaking change: Models with dynamic fields (e.g., Row, Document) now store user-defined data in a typed .data property instead of direct attribute access
• Breaking change: Added pydantic>=2,<3 as a required dependency
• Breaking change: Minimum Python version raised from 3.5 to 3.9
• Added AppwriteModel base class (Pydantic BaseModel) for all response models with from_dict() and to_dict() helpers
• Added 130+ typed model classes under appwrite/models/ (e.g., Database, Collection, Document, User, Session, File, Bucket, etc.)
• Added Generic[T] support for models with dynamic fields (e.g., Row, Document) - pass model_type=YourModel to methods like get_row() or list_rows() for type-safe access to user-defined data via result.data.field_name
• Updated README with uv add appwrite installation example
• Updated all doc examples to use typed response models (e.g., result: TemplateFunctionList = functions.list_templates(...))

Full Changelog: 15.3.0...16.0.0

16.0.0rc1

What's Changed

• Breaking change: All service methods now return typed Pydantic models instead of Dict[str, Any]
• Breaking change: Models with dynamic fields (e.g., Row, Document) now store user-defined data in a typed .data property instead of direct attribute access
• Breaking change: Added pydantic>=2,<3 as a required dependency
• Breaking change: Minimum Python version raised from 3.5 to 3.9
• Added AppwriteModel base class (Pydantic BaseModel) for all response models with from_dict() and to_dict() helpers
• Added 130+ typed model classes under appwrite/models/ (e.g., Database, Collection, Document, User, Session, File, Bucket, etc.)
• Added Generic[T] support for models with dynamic fields (e.g., Row, Document) - pass model_type=YourModel to methods like get_row() or list_rows() for type-safe access to user-defined data via result.data.field_name
• Updated README with uv add appwrite installation example
• Updated all doc examples to use typed response models (e.g., result: TemplateFunctionList = functions.list_templates(...))

Full Changelog: 15.3.0...16.0.0rc1

15.3.0

What's Changed

• Added get_console_pausing health endpoint
• Added ttl parameter to list_documents and list_rows for cached responses
• Added optional activate parameter to Sites.create_deployment
• Updated docs and examples to reflect TTL usage and activation
• Updated query filtering docs in Messaging service

Full Changelog: 15.2.0...15.3.0