NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev · #3385 most downloaded on pub.dev
The most famous and powerful Dart/Flutter library for Bluesky Social.
Last release today
08 Oct 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
1 version withdrawn
withdrawn after publishing
4 years old
246 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.
IdentityServiceLabelServiceRepoServiceServerServiceSyncServiceActorServiceFeedServiceGraphServiceNotificationServiceUnspeccedServiceheaders parameters on GET endpoints. You can specify additional headers.ModerationUI object.
filterbluralertinformgetLabelerHeaders function..getModerationPrefs method on Preferences object as an extension..getLabelDefinitions to LabelerService as an extension.Add privileged input and property on ServerService.createAppPassword, AppPassword.
privileged input and property on ServerService.createAppPassword, AppPassword. (#1494)Add .getLabelDefinitions function for moderation API.
.getLabelDefinitions function for moderation API.Merged the official algorithm of the moderation API. Exposed the following functions.
moderatePostmoderateProfilemoderateNotificationmoderateFeedGeneratormoderateUserListAdd .chat property on ProfileAssociated object.
.chat property on ProfileAssociated object. (#1448)Removed deprecated properties on Bluesky object.
lex_annotation.Bluesky object.Add .grandparentAuthor property on Reply.
.grandparentAuthor property on Reply. (#1439)Add a pattern SavedFeedsPrefV2 on Preference.
SavedFeedsPrefV2 on Preference. (#1420)
SavedFeedsPrefV2SavedFeedAdd authFactorToken parameter on createSession.
Removed viewer parameter from searchActorsTypeahead.
Add viewer param on ActorService.searchActorsTypeahead
viewer param on ActorService.searchActorsTypeaheadreplyCount, repostCount, likeCount on EmbedViewRecordViewRecordacceptsInteractions on FeedService.generator and GeneratorRecordviewer on UnspeccedService.searchActorsSkeletonFeedService.searchPosts
sortsinceuntilmentionsauthorlangdomainurltagFeedService.searchActorsSkeleton
sortsinceuntilmentionsauthorlangdomainurltagviewer.sendInteractions on FeedServicefeedContext property
FeedViewSkeletonFeedViewacceptsInteractions on FeedGeneratorViewAdded global .headers on Bluesky.
.headers on Bluesky. (#1360)Added labelerDid on ContentLabelPreference.
labelerDid on ContentLabelPreference. (#1316).associated property on Actor, ActorBasic, ActorProfile. (#1316)LabelerService. (#1316)
.labeler on Bluesky object
.getServices.service.isLabelerService and .isNotLabelerService on AT URI extensionLabelerServiceRecord object.onCreateLabelerService and .onDeleteLabelerService on RepoCommitAdaptor object.labels properties on FeedGeneratorView, ListView, ListViewBasic object..labelersPref on Preference..treeViewEnabled on ThreadViewPreference.Revert show element on ContentLabelVisibility. This element is the same with ignore.
BugFix: MutedWordPref is now working correctly.
MutedWordPref is now working correctly. (#1312)- 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).activateAccount on ServerService. (#1276).deactivateAccount on ServerService. (#1278).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)MutedWordsPref and HiddenPostsPref. Returned from ActorService.getPreferences. (#1288)identity event on .subscribeRepos. (#1289)Added TempService. You can use it like bsky.temp.
TempService. You can use it like bsky.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 Bluesky. (#1254).timelineIndex on SavedFeedsPreference. (#1251)parameters arg and you can pass bytes to body arg on .post method. (#1252)Removed getTimelineSkeleton from UnspeccedService.
Added .get and .post methods on Bluesky object.
.get and .post methods on Bluesky object. (#1217)bluesky/lex_namespaces package. You can use these constants for .get and .post methods.- Upgraded atproto_core.
atproto_core. (#1159)Removed .show element on ContentLabelVisibility. The value of show is internally converted to ignore.
.show element on ContentLabelVisibility. The value of show is internally converted to ignore. (#1157)- Minor improvement.
- Exposed RepoServiceExtension.
RepoServiceExtension. (#1137)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…
seenAt parameter on listNotifications.Support nobody option for threadgate.
nobody option for threadgate.Fixed a bug in converting Threadgate records.
Deprecated property names on ATProto and Bluesky.
atproto_core. (#1112)streamService and added relayService instead. Defaults to bsky.network. (#1116)IdentitiesService to IdentityServiceLabelsService to LabelServiceRepositoriesService to RepoServiceServersService to ServerServiceActorsService to ActorServiceFeedsService to FeedServiceGraphsService to GraphServiceNotificationsService to NotificationServiceATProto and Bluesky. (#1118)
.servers: Use .server instead.identities: Use .identity instead.repositories: Use .repo instead.labels: Use .label instead.actors: Use .actor instead.feeds: Use .feed instead.graphs: Use .graph instead.notifications: Use .notification insteadUpgraded atproto and atproto_core.
atproto and atproto_core. (#1102)Added .toActor method on ActorBasic.
.toActor method on ActorBasic. (#1095)Changed types from Actor to ActorBasic on following objects.
Elevate !no-unauthenticated label to affect the entire account when on the profile.
Apply automatic generation of moderation sources.
Nothing published for this version
Add !no-unauthenticated imperative label.
!no-unauthenticated imperative label. (#1038)Removed all .find*AsJson and .paginate*AsJson.
Added ignore on ContentLabelVisibility and deprecated show element.
Added moderation APIs and exposed bluesky/moderation package. See more details.
- Added uri on ListItem.
uri on ListItem. (#1026)Removed entities field on PostRecord. Instead of this field, entities is merged internally to facets field.
entities field on PostRecord. Instead of this field, entities is merged internally to facets field.Added deprecated entities field on PostRecord.
entities field on PostRecord. (#1020)
LegacyFacetTextSliceAdded .isReplyDisabled and .isNotReplyDisabled properties on PostViewer.
.isReplyDisabled and .isNotReplyDisabled properties on PostViewer. (#1019)Added .findLinkPreview function. ThiIts returns preview information for a given URL.
.findLinkPreview function. ThiIts returns preview information for a given URL. (#1009)Fixed a bug that occurred in #1010. getCustomFeed behaves differently depending on whether or not an access token is given.
Changed auth type from access to anonymous for app.bsky.feed.getFeed.
app.bsky.feed.getFeed. (#1010)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.
com.atproto.sync.getBlob on SyncService. (#307)
.findBlobcom.atproto.sync.listBlobs on SyncService. (#314)
.findBlobs.findBlobsAsJson.paginateBlobs.paginateBlobsAsJsonq param internally on ActorsService. (#849)
.searchActors.searchTypeaheadapp.bsky.graph.getListBlocks on GraphsService. (#793)
.findBlockLists.findBlockListsAsJson.paginateBlockLists.paginateBlockListsAsJsonblockingByList on ActorViewer. (#952)Bluesky, and added .session property. (#961)Supported app.bsky.feed.searchPosts on FeedsService.
app.bsky.feed.searchPosts on FeedsService. (#845)
.searchPostsByQuery.searchPostsByQueryAsJson.paginatePostsByQuery.paginatePostsByQueryAsJsonapp.bsky.unspecced.searchPostsSkeleton on UnspeccedService. (#848)
.searchPostsByQuerySkeleton.searchPostsByQuerySkeletonAsJson.paginatePostsByQuerySkeleton.paginatePostsByQuerySkeletonAsJsonapp.bsky.unspecced.searchActorsSkeleton on UnspeccedService. (#847)
.searchActorsByQuerySkeleton.searchActorsByQuerySkeletonAsJson.paginateActorsByQuerySkeleton.paginateActorsByQuerySkeletonAsJsonapp.bsky.feed.threadgate on FeedsService. (#815)
.createThreadgateThreadRuleThreadMentionRuleThreadFollowingRuleThreadListRule.onCreateThreadgate and .onDeleteThreadgate events on RepoCommitAdaptor. Also added ThreadgateRecord.Removed deprecated methods and object.
rev on Repo object. (#885).refreshSession: Use function version instead..findRepoCheckout.findRepoCheckoutAsJson.findRepoHead.findRepoHeadAsJsonDeprecated app.bsky.unspecced.getPopular. Find a feed generator alternative.
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)
updateEmailapp.bsky.unspecced.getPopular. Find a feed generator alternative. (#835)
.findPopularFeed.findPopularFeedAsJson.paginatePopularFeed.paginatePopularFeedAsJsonapp.bsky.unspecced.applyLabels from UnspeccedService. (#846)Supported hashtag on FacetFeature.tag and FacetTag. Also added tags parameter to .createPost on FeedsService.
FacetFeature.tag and FacetTag. Also added tags parameter to .createPost on FeedsService. (#839)Supported actor preferences #feedViewPref and #threadViewPref.
#feedViewPref and #threadViewPref. (#831)
Preference.feedViewPreference.threadViewDropped includeReasons param from methods on Notifications. Instead, pass NotificationReasonFilter object as an argument.
includeReasons param from methods on Notifications. Instead, pass NotificationReasonFilter object as an argument. (#826)
.group.groupByHour.groupByMinuteAdded .groupByHour and .groupByMinute on Notifications object. You can adjust the unit of grouping in hours or minutes when grouping notifications.
.groupByHour and .groupByMinute on Notifications object. You can adjust the unit of grouping in hours or minutes when grouping notifications. (#821)Your coding agent can read these notes before it upgrades. Set up the MCP server →