NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev · #3662 most downloaded on pub.dev
The most famous and powerful Dart/Flutter library for AT Protocol.
Last release 1 months ago
09 Aug 2026
Release timing varies
gaps range from 8 days to 3 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
4 years old
136 releases · first in 2023
One column per quarter.
Nothing published for this version
Don't include Auth headers in .headers.
.headers.Bump atproto_core. Add auth scope com.atproto.appPassPrivileged.
atproto_core. Add auth scope com.atproto.appPassPrivileged. (#1501).headers property. Returns the merged headers with global headers and auth header.Removed deprecated methods from following services.
IdentityServiceLabelServiceRepoServiceServerServiceSyncServiceheaders parameters on GET endpoints. You can specify additional headers.Add privileged input and property on ServerService.createAppPassword, AppPassword.
privileged input and property on ServerService.createAppPassword, AppPassword. (#1494)Removed deprecated properties on ATProto object.
lex_annotation.ATProto object.Add authFactorToken parameter on createSession.
Added global .headers on ATProto.
.headers on ATProto. (#1360)Supported Labeler Service's objects.
LabelValueLabelValueDefinitionLabelValueDefinitionStringsLabel object.
verexpsig.contact property on output of ServerService.describeServer.- Upgrade at_uri.
at_uri. (#1300)Removed temp endpoints from TempService.
TempService.
.importRepo.pushBlob.transferAccountdid property on ServerInfo object. Returned from ServerService.describeServer. (#1279).getServiceAuth on ServerService. (#1280).deactivateAccount on ServerService. (#1278).activateAccount on ServerService. (#1276).checkAccountStatus on ServerService. (#1277).listMissingBlobs on RepoService. (#1275).importRepo on RepoService. (#1274).submitPlcOperation on IdentityService. (#1273).signPlcOperation on IdentityService. (#1272).getRecommendedDidCredentials on IdentityService. (#1270).requestPlcOperationSignature on IdentityService. (#1271)identity event on .subscribeRepos. (#1289)Added TempService. You can use it like atproto.temp.
TempService. You can use it like atproto.temp. (#1238)
.checkSignupQueue.importRepo.pushBlob.requestPhoneVerification.transferAccountImproved redundant error messages. Now it shows like GET https://bsky.social/xrpc/com.atproto.identity.resolveHandle 400 Error: Params must have the p
GET https://bsky.social/xrpc/com.atproto.identity.resolveHandle 400 Error: Params must have the property "handle". (#1253).service and .relayService properties on ATProto. (#1254)plcOp param on ServerService.createAccount. (#969)Added .get and .post methods on ATProto object.
.get and .post methods on ATProto object. (#1217)atproto/lex_namespaces package. You can use these constants for .get and .post methods.- Upgraded atproto_core.
atproto_core. (#1159)- Minor improvement.
Change the method name of each service to Lexicon's ID. Existing methods have been deprecated and should be replaced according to the deprecation mess…
- Add rkey on .createRecord.
rkey on .createRecord.Deprecated property names on ATProto.
atproto_core. (#1112)streamService and added relayService instead. Defaults to bsky.network. (#1116)IdentitiesService to IdentityServiceLabelsService to LabelServiceRepositoriesService to RepoServiceServersService to ServerServiceATProto. (#1118)
.servers: Use .server instead.identities: Use .identity instead.repositories: Use .repo instead.labels: Use .label instead- Upgraded atproto_core.
atproto_core. (#1102)Removed all .find*AsJson and .paginate*AsJson.
.find*AsJson and .paginate*AsJson. (#1033)Changed isNegate of Label object to false by default.
isNegate of Label object to false by default. (#1006)- Upgraded atproto_core.
atproto_core. (#1009)- Upgraded atproto_core.
atproto_core. (#1012)Fixed a bug that service names were not specified correctly when using stream endpoints.
atproto_core. (#999).streamService property on ATProto. Defaults to bsky.network.Added .didDoc on CurrentSession.
Supported com.atproto.labels.queryLabels and LabelsService.
com.atproto.labels.queryLabels and LabelsService. (#265)com.atproto.labels.subscribeLabels on LabelsService. (#340).deleteSession function. (#963)com.atproto.server.reserveSigningKey on ServersService. (#953)
.createSigningKeydidDoc field on Session and Account objects. (#968)Supported com.atproto.sync.getBlob on SyncService.
Removed deprecated methods and object.
rev on Repo object. (#885).refreshSession: Use function version instead..findRepoCheckout.findRepoCheckoutAsJson.findRepoHead.findRepoHeadAsJsonAdded isEmailConfirmed field on CurrentSession.
isEmailConfirmed field on CurrentSession. (#857)com.atproto.server.requestEmailUpdate on ServersService. (#859)
requestEmailUpdatecom.atproto.server.requestEmailConfirmation on ServersService. (#858)
requestEmailConfirmationcom.atproto.server.confirmEmail on ServersService. (#855)
requestEmailConfirmationcom.atproto.server.updateEmail on ServersService. (#860)
updateEmailUpgraded xrpc package. Fixed field names for rate limit.
xrpc package. Fixed field names for rate limit.- Upgraded at_uri.
at_uri. (#797)Added .accessToken and .refreshToken properties on Session object. You can get decoded token objects based on JWT tokens. Also you can decode JWT toke
.accessToken and .refreshToken properties on Session object. You can get decoded token objects based on JWT tokens. Also you can decode JWT token with decodeJwt function. (#787)Improved union type to always return Unknown type if conversion to a specific type fails. With this fix, an exception/error is no longer thrown when c
Removed fully deprecated endpoint on SyncService.
Platform enum. (#709)isValidAppPassword function. (#713)SyncService. (#716)
findRepoCommitPathsfindRepoCommitPathsAsJsonSyncService. (#717)
findRepoCheckoutfindRepoCheckoutAsJsonfindRepoHeadfindRepoHeadAsJson.findRepoCommits and .findRepoCommitsAsJson on SyncService. (#718)
earliestCommitCidlatestCommitCidsinceCommitCidrebaseRepo method on RepositoriesService.findLatestCommit method on SyncService. Use it instead of findRepoHead. (#720)SubscribedRepoCommit object. (#719)
revsince (nullable)Moved Session object and createSession function to atproto_core. And exposed refreshSession as a function. Also deprecated ServersService.refreshSessi…
Session object and createSession function to atproto_core. And exposed refreshSession as a function. Also deprecated ServersService.refreshSession method. (#686)Supported com.atproto.sync.notifyOfUpdate as notifyCrawlingServiceOfUpdate on SyncService.
Exposed freezed union objects. You can use them for pattern matching.
labels.dart
ULabelsSelLabelsULabelsUnknownreport_subject.dart
UReportSubjectRepoRefUReportSubjectStrongRefUReportSubjectUnknownsubscribed_repo.dart
USubscribedRepoCommitUSubscribedRepoHandleUSubscribedRepoMigrateUSubscribedRepoTombstoneUSubscribedRepoInfoUSubscribedRepoUnknownbatch_action.dart
UBatchActionCreateUBatchActionUpdateUBatchActionDeleteDrop support for null unsafe Dart, bump SDK constraint to '^3.0.0'.
Added SelfLabel, SelfLabels, Labels objects.
SelfLabel, SelfLabels, Labels objects. (#654)Upgraded atproto_core and exposed RateLimit and RateLimitPolicy objects.
Exposed lexicon ids from com.atproto as ids.dart.
com.atproto as ids.dart. (#623)- Optimized internal processing.
Added documentations to model objects.
Upgraded atproto_core. Fixed minor things.
atproto_core. Fixed minor things.Removed deprecated properties. This is a property that was planned to be turned off in v0.6.0, so there are no breaking changes.
v0.6.0, so there are no breaking changes.A method to retrieve response data as JSON from endpoints that perform GET communication has been added. These processes do not convert to a specific
IdentitiesService
findDIDAsJsonRepositoriesService
findRecordAsJsonfindRecordsAsJsonfindRepoInfoAsJsonServersService
findCurrentSessionAsJsonfindInviteCodesAsJsonfindAppPasswordsAsJsonfindServerInfoAsJsonSyncService
findRepoCommitsAsJsonfindRepoCommitPathsAsJsonfindRepoBlocksAsJsonfindRepoCheckoutAsJsonfindRepoHeadAsJsonfindRecordAsJsonfindReposAsJsonSupported com.atproto.server.describeServer as findServerInfo in ServersService.
com.atproto.server.describeServer as findServerInfo in ServersService. (#260)com.atproto.server.createInviteCodes as createInviteCodes in ServersService. (#258)identifier in createSession is now required.UnsupportedError when an anonymous user tries to access an endpoint that requires authentication. (#564)Added homepage in pubspec.yaml.
Supported com.atproto.sync.getRepo as findRepoCommits in SyncService.
com.atproto.sync.getRepo as findRepoCommits in SyncService. (#313)com.atproto.sync.getCommitPath as findRepoCommitPaths in SyncService. (#310)com.atproto.sync.getBlocks as findRepoBlocks in SyncService. (#308)com.atproto.sync.getCheckout as findRepoCheckout in SyncService. (#309)com.atproto.sync.getHead as findRepoHead in SyncService. (#311)com.atproto.sync.getRecord as findRecord in SyncService. (#312)com.atproto.repo.listRecords as findRecords in RepositoriesService. (#305)com.atproto.repo.rebaseRepo as rebaseRepo in RepositoriesService. (#509)com.atproto.sync.listRepos as findRepos in SyncService. (#315)Repo to RepoInfo returned from findRepoInfo in RepositoriesService.RecordValue to Record. And now createRecord and updateRecord returns StrongRef. (#511)BlobContext and LegacyBlob. Blobs in the old format were modified to be converted to the new format. (#514)Improved generation of CID hash codes, allowing CID objects to be specified as keys for Maps, etc.
Nothing published for this version
Refactored subscribeRepoUpdates.
subscribeRepoUpdates. (#472)handle parameter in findDID is now required.
Fixed type from StrongRef to Record of updateRecord in RepositoriesService.
StrongRef to Record of updateRecord in RepositoriesService.">=2.17.0 <4.0.0". (#406)Supported com.atproto.repo.applyWrites as updateBulk in RepositoriesService. Also added following utilities.
com.atproto.repo.applyWrites as updateBulk in RepositoriesService. Also added following utilities. (#306)
createRecordsupdateRecordsdeleteRecordstoStrongRef() method in Record and RecordValue. Be sure to check with hasStrongRef or hasNotStrongRef when you use toStrongRef() from RecordValue, because cid in RecordValue is nullable. (#367)Added unknown fields for union types. The AT Protocol allows some endpoints to create records of types not officially supported. In such cases, the un
unknown fields for union types. The AT Protocol allows some endpoints to create records of types not officially supported. In such cases, the unknown field is used to store the raw JSON for a safe and user-choice implementation. (#350)Removed did parameter from findRecord in RepositoriesService.
did parameter from findRecord in RepositoriesService.- Added label.dart.
label.dart. (#346)Added additional fields in InviteCode object.
Your coding agent can read these notes before it upgrades. Set up the MCP server →