What's Changed

• Added: Organization service for managing app installations
• Added: app installation management methods to the Teams service
• Added: account OAuth2 consent methods listConsents, getConsent, deleteConsent
• Added: account consent token methods listConsentTokens, getConsentToken, deleteConsentToken
• Added: folder parameter to storage.createFile, and folder and key to File
• Fixed: Null optional parameters are no longer sent in request bodies
• Fixed: Binary endpoints now authenticate with headers, not query parameters

Full Changelog: 25.3.0...25.4.0

• Added: Organization service for managing app installations
• Added: app installation management methods to the Teams service
• Added: account OAuth2 consent methods listConsents, getConsent, deleteConsent
• Added: account consent token methods listConsentTokens, getConsentToken, deleteConsentToken
• Added: folder parameter to storage.createFile, and folder and key to File
• Fixed: Null optional parameters are no longer sent in request bodies
• Fixed: Binary endpoints now authenticate with headers, not query parameters

25.4.0

Compare

Choose a tag to compare

What's Changed

• Added: Client.setBearer() method for OAuth access token authentication
• Added: Query.vectorDot, Query.vectorCosine, Query.vectorEuclidean vector similarity query methods
• Added: appwrite value to OAuthProvider enum
• Added: Locale model fields: city, timeZone, postalCode, latitude, longitude, ISP and connection details
• Updated: Log model docs now include hidden user type

Full Changelog: 25.2.0...25.3.0

• Added: Client.setBearer() method for OAuth access token authentication
• Added: Query.vectorDot, Query.vectorCosine, Query.vectorEuclidean vector similarity query methods
• Added: appwrite value to OAuthProvider enum
• Added: Locale model fields: city, timeZone, postalCode, latitude, longitude, ISP and connection details
• Updated: Log model docs now include hidden user type

25.3.0

Compare

Choose a tag to compare

What's Changed

• Added: Realtime connections now authenticate with the configured JWT.
• Added: Forwarded impersonateUserId on avatars and storage file requests.

Full Changelog: 25.1.0...25.2.0

• Added: Realtime connections now authenticate with the configured JWT.
• Added: Forwarded impersonateUserId on avatars and storage file requests.

25.2.0

Compare

Choose a tag to compare

What's Changed

• Added: Email metadata fields to User (emailCanonical, emailIsFree, emailIsDisposable, emailIsCorporate, emailIsCanonical).
• Added: Membership.userAccessedAt field.
• Updated: Requests now send an explicit accept header matching each endpoint's response type.
• Changed: Client.call() no longer sends the x-appwrite-project header by default.

Full Changelog: 25.0.0...25.1.0

• Added: Email metadata fields to User (emailCanonical, emailIsFree, emailIsDisposable, emailIsCorporate, emailIsCanonical).
• Added: Membership.userAccessedAt field.
• Updated: Requests now send an explicit accept header matching each endpoint's response type.

25.1.0

Compare

Choose a tag to compare

What's Changed

• Breaking: avatars.getScreenshot theme parameter now uses the BrowserTheme enum
• Breaking: Removed generic type parameters from presences service methods
• Replaced: BrowserTheme enum
• Updated: Presence model is now concrete and adds a metadata field

Full Changelog: 24.2.0...25.0.0

• Breaking: avatars.getScreenshot theme parameter now uses the BrowserTheme enum
• Breaking: Removed generic type parameters from presences service methods
• Replaced: BrowserTheme enum
• Updated: Presence model is now concrete and adds a metadata field

25.0.0

Compare

Choose a tag to compare

What's Changed

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

Full Changelog: 24.1.1...24.2.0

24.2.0

Compare

Choose a tag to compare

What's Changed

• Fixed: Removed Advisor service and Insight, InsightCTA, InsightList, Report, ReportList models (admin-only endpoints, not intended for client SDKs)
• Added: sizeActual field to File model
• Updated: Refreshed code formatting from the SDK generator

Full Changelog: 24.1.0...24.1.1

• Fixed: Removed Advisor service and Insight, InsightCTA, InsightList, Report, ReportList models (admin-only endpoints, not intended for client SDKs)
• Added: sizeActual field to File model
• Updated: Refreshed code formatting from the SDK generator

24.1.1

Compare

Choose a tag to compare

What's Changed

• Added: Realtime presences channel and RealtimePresence types for presence subscriptions
• Added: Advisor and Presences services
• Added: Insight, Presence, and Report models with list variants
• Added: fusionauth, keycloak, and kick providers to OAuthProvider enum
• Updated: X-Appwrite-Response-Format header to 1.9.5

Full Changelog: 24.0.0...24.1.0

• Added: Realtime presences channel and RealtimePresence types for presence subscriptions
• Added: Advisor and Presences services
• Added: Insight, Presence, and Report models with list variants
• Added: fusionauth, keycloak, and kick providers to OAuthProvider enum
• Updated: X-Appwrite-Response-Format header to 1.9.5

24.1.0

Compare

Choose a tag to compare

What's Changed

• Breaking: Added unsubscribe(), update(), and close() to Realtime subscriptions
• Added: Added userPhone field to Membership model
• Updated: Updated X-Appwrite-Response-Format header to 1.9.2

Full Changelog: 23.1.0...24.0.0

• Breaking: Added unsubscribe(), update(), and close() to Realtime subscriptions
• Added: Added userPhone field to Membership model
• Updated: Updated X-Appwrite-Response-Format header to 1.9.2

24.0.0

Compare

Choose a tag to compare

• Added x OAuth provider to OAuthProvider enum
• Added userType field to Log model
• Added getHeaders() method to Client
• Updated X-Appwrite-Response-Format header to 1.9.1
• Updated TTL description for list caching in Databases and TablesDB

• [BREAKING] Changed $sequence type from int to String for Row and Document models
• Added impersonation support: setImpersonateUserId(), setImpersonateUserEmail(), setImpersonateUserPhone() on Client, ClientBrowser, and ClientIO
• Added impersonator and impersonatorUserId optional fields to User model
• Updated Log model field descriptions to clarify impersonation behavior for userId, userEmail, userName
• Updated X-Appwrite-Response-Format header to 1.9.0
• Updated README badge to API version 1.9.x and dependency example to ^23.0.0

• Breaking: Channel API no longer defaults to '*'; explicit IDs required.
• Updated: Docs and README reflect 21.4.1; TTL examples added.

• Add queries parameter to Realtime subscriptions for filtering events
• Fix Roles enum removed from Teams service; roles parameter now accepts List<String>
• Fix doc examples with proper formatting and syntax highlighting

• Add array-based enum parameters (e.g., permissions: List<BrowserPermission>).
• Breaking change: Output enum has been removed; use ImageFormat instead.
• Add Channel helpers for Realtime.

• Fix boolean parameter not handled correctly in Client requests

• Fix OAuth2 browser infinite redirect issue

• Fix passing of null values and stripping only non-nullable optional parameters from the request body
• Add getScreenshot method to Avatars service
• Add Theme, Timezone and Output enums

• Add total parameter to list queries allowing skipping counting rows in a table for improved performance
• Add Operator class for atomic modification of rows via update, bulk update, upsert, and bulk upsert operations

• Widen device_info_plus and package_info_plus dependencies to allow for newer versions for Android 15+ support
• Fix CHUNK_SIZE constant to chunkSize
• Fix missing @override annotation to toMap method in all model classes

• Add transaction support for Databases and TablesDB

• Deprecate createVerification method in Account service
• Add createEmailVerification method in Account service

• Add orderRandom query support

• Rename CreditCard enum value unionChinaPay to unionPay
• Add time between query support
• Add spatial query support

• Support for Appwrite 1.8
• Added TablesDB service
• Added new query types:
  • notContains
  • notSearch
  • notBetween
  • notStartsWith
  • notEndsWith
  • createdBefore
  • createdAfter
  • updatedBefore
  • updatedAfter
• Deprecated updateMagicURLSession
• Deprecated updatePhoneSession
• Deprecated Databases service

The TablesDB service is the new recommended way to work with databases. Existing databases/collections/attributes/documents can be managed using the TablesDB service. Existing Databases service will continue to work, but new features may only be added to the TablesDB service.

• Add incrementDocumentAttribute and decrementDocumentAttribute support to Databases service
• Add gif support to ImageFormat enum
• Add sequence support to Document model

• Add gif support to ImageFormat enum
• Fix convertTo() method in Document and Preferences models to correctly accept Map<String, dynamic>

• Fix devKeys support by conditionally including credentials during requests

• Update flutter_web_auth_2 dependency to version 4.1.0
• Update auth.html example in README.md to align with flutter_web_auth_2 documentation
• Breaking changes:
  • Minimum iOS version supported is now 17.4 due to the updated requirements of flutter_web_auth_2 version 4.1.0

• Add setDevKey method to Client service
• Add upsertDocument method to Databases service

• Remove Gif from ImageFormat enum
• Remove search param from listExecutions method
• Add token param to getFilePreview and getFileView for File tokens usage
• Update default quality for getFilePreview from 0 to -1

• Avoid setting empty User-Agent header and only encode it when present.
• Update doc examples to use new multi-region endpoint: https://<REGION>.cloud.appwrite.io/v1.

• Removed Content-Type header from GET and HEAD requests.
• Add validation for setting endpoint in setEndpoint and setEndPointRealtime methods.
• Include Figma in list of available OAuth providers.

• Encode User-Agent header to fix invalid HTTP header field value error.
• Breaking changes:
  • Changed the typing of AppwriteException's response parameter from a dynamic object to an optional string (?String).

• Fixed realtime pong response.
• Fixed issues with chunkedUpload method.

• Fixed realtime reconnection issues
• Support for Appwrite 1.6
• Update dependencies
• Added scheduledAt attribute to Execution response model
• Added scheduledAt parameter to createExecution(): Enables creating a delayed execution
• Breaking changes:
  • Removed otp parameter from deleteMFAAuthenticator.

You can find the new syntax for breaking changes in the Appwrite API references. Select version 1.6.x.

Please note: This version is compatible with Appwrite 1.6 and later only. If you do not update your Appwrite SDK, old SDKs will not break your app. Appwrite APIs are backwards compatible.

• Fixed concurrent modification error when closing realtime socket

• Upgrade dependencies

• Fixed realtime multiple subscription issues

• Fixed parameters using enum types

• Added enum support
• Added SSR support
• Added messaging service support
• Added contains query support
• Added or query support

• Fix between queries

• Parameter url is now optional in the createMembership endpoint

• Added a new label function to the Role helper class
• Update internal variable names to prevent name collision
• Fix: content range header inconsistency in chunked uploads #648

• Support for Appwrite 1.4.0
• New endpoints for fetching user identities
• New endpoints for listing locale codes
• Updated documentation
• Breaking changes:
  • The createFunction method has a new signature.
  • The createExecution method has a new signature.
  • The updateFunction method has a new signature.
  • The createDeployment method no longer requires an entrypoint.
  • The updateFile method now includes the ability to update the file name.
  • The updateMembershipRoles method has been renamed to updateMembership.

• Added documentation comments
• Added unit tests
• Upgraded dependencies

• Added relationships support
• Added support for new queries: isNull, isNotNull, startsWith, notStartsWith, endsWith, between and select.
• Added update attribute support
• Added team prefs support
• Changed function create/update execute parameter to optional
• Changed team update to updateName
• Changed Account service to use the User model instead of Account

• Fix: back navigation bringing back web browser after OAuth session creation
• Update: Deprecated InputFile default constructor and introduced InputFile.fromPath and InputFile.fromBytes for consistency with other SDKs

• Fix: notify callback when websocket closes #604

• Fix OAuth on web
• Improve helper classes

• Support for GraphQL