📄️ Introduction
This section contains HTTP API reference docs for Bluesky and AT Protocol lexicons. Generate a bearer token to test API calls directly from the docs.
📄️ app.bsky.actor.getPreferences
Get private preferences attached to the current account. Expected use is synchronization between multiple devices, and import/export during account migration. Requires auth.
📄️ app.bsky.actor.getProfile
Get detailed profile view of an actor. Does not require auth, but contains relevant metadata with auth.
📄️ app.bsky.actor.getProfiles
Get detailed profile views of multiple actors.
📄️ app.bsky.actor.getSuggestions
Get a list of suggested actors. Expected use is discovery of accounts to follow during new account onboarding.
📄️ app.bsky.actor.putPreferences
Set the private preferences attached to the account.
📄️ app.bsky.actor.searchActorsTypeahead
Find actor suggestions for a prefix search term. Expected use is for auto-completion during text field entry. Does not require auth.
📄️ app.bsky.actor.searchActors
Find actors (profiles) matching search criteria. Does not require auth.
📄️ app.bsky.feed.describeFeedGenerator
Get information about a feed generator, including policies and offered feed URIs. Does not require auth; implemented by Feed Generator services (not App View).
📄️ app.bsky.feed.getActorFeeds
Get a list of feeds (feed generator records) created by the actor (in the actor's repo).
📄️ app.bsky.feed.getActorLikes
Get a list of posts liked by an actor. Does not require auth.
📄️ app.bsky.feed.getAuthorFeed
Get a view of an actor's 'author feed' (post and reposts by the author). Does not require auth.
📄️ app.bsky.feed.getFeedGenerator
Get information about a feed generator. Implemented by AppView.
📄️ app.bsky.feed.getFeedGenerators
Get information about a list of feed generators.
📄️ app.bsky.feed.getFeedSkeleton
Get a skeleton of a feed provided by a feed generator. Auth is optional, depending on provider requirements, and provides the DID of the requester. Implemented by Feed Generator Service.
📄️ app.bsky.feed.getFeed
Get a hydrated feed from an actor's selected feed generator. Implemented by App View.
📄️ app.bsky.feed.getLikes
Get like records which reference a subject (by AT-URI and CID).
📄️ app.bsky.feed.getListFeed
Get a feed of recent posts from a list (posts and reposts from any actors on the list). Does not require auth.
📄️ app.bsky.feed.getPostThread
Get posts in a thread. Does not require auth, but additional metadata and filtering will be applied for authed requests.
📄️ app.bsky.feed.getPosts
Gets post views for a specified list of posts (by AT-URI). This is sometimes referred to as 'hydrating' a 'feed skeleton'.
📄️ app.bsky.feed.getRepostedBy
Get a list of reposts for a given post.
📄️ app.bsky.feed.getSuggestedFeeds
Get a list of suggested feeds (feed generators) for the requesting account.
📄️ app.bsky.feed.getTimeline
Get a view of the requesting account's home timeline. This is expected to be some form of reverse-chronological feed.
📄️ app.bsky.feed.searchPosts
Find posts matching search criteria, returning views of those posts.
📄️ app.bsky.feed.sendInteractions
Send information about interactions with feed items back to the feed generator that served them.
📄️ app.bsky.graph.getActorStarterPacks
Get a list of starter packs created by the actor.
📄️ app.bsky.graph.getBlocks
Enumerates which accounts the requesting account is currently blocking. Requires auth.
📄️ app.bsky.graph.getFollowers
Enumerates accounts which follow a specified account (actor).
📄️ app.bsky.graph.getFollows
Enumerates accounts which a specified account (actor) follows.
📄️ app.bsky.graph.getKnownFollowers
Enumerates accounts which follow a specified account (actor) and are followed by the viewer.
📄️ app.bsky.graph.getListBlocks
Get mod lists that the requesting account (actor) is blocking. Requires auth.
📄️ app.bsky.graph.getListMutes
Enumerates mod lists that the requesting account (actor) currently has muted. Requires auth.
📄️ app.bsky.graph.getList
Gets a 'view' (with additional context) of a specified list.
📄️ app.bsky.graph.getLists
Enumerates the lists created by a specified account (actor).
📄️ app.bsky.graph.getMutes
Enumerates accounts that the requesting account (actor) currently has muted. Requires auth.
📄️ app.bsky.graph.getRelationships
Enumerates public relationships between one account, and a list of other accounts. Does not require auth.
📄️ app.bsky.graph.getStarterPack
Gets a view of a starter pack.
📄️ app.bsky.graph.getStarterPacks
Get views for a list of starter packs.
📄️ app.bsky.graph.getSuggestedFollowsByActor
Enumerates follows similar to a given account (actor). Expected use is to recommend additional accounts immediately after following one account.
📄 ️ app.bsky.graph.muteActorList
Creates a mute relationship for the specified list of accounts. Mutes are private in Bluesky. Requires auth.
📄️ app.bsky.graph.muteActor
Creates a mute relationship for the specified account. Mutes are private in Bluesky. Requires auth.
📄️ app.bsky.graph.muteThread
Mutes a thread preventing notifications from the thread and any of its children. Mutes are private in Bluesky. Requires auth.
📄️ app.bsky.graph.unmuteActorList
Unmutes the specified list of accounts. Requires auth.
📄️ app.bsky.graph.unmuteActor
Unmutes the specified account. Requires auth.
📄️ app.bsky.graph.unmuteThread
Unmutes the specified thread. Requires auth.
📄️ app.bsky.labeler.getServices
Get information about a list of labeler services.
📄️ app.bsky.notification.getUnreadCount
Count the number of unread notifications for the requesting account. Requires auth.
📄️ app.bsky.notification.listNotifications
Enumerate notifications for the requesting account. Requires auth.
📄️ app.bsky.notification.putPreferences
Set notification-related preferences for an account. Requires auth.
📄️ app.bsky.notification.registerPush
Register to receive push notifications, via a specified service, for the requesting account. Requires auth.
📄️ app.bsky.notification.updateSeen
Notify server that the requesting account has seen notifications. Requires auth.