At this level
app.bsky · 9- app.bsky.authCreatePosts permission-set
- app.bsky.authDeleteContent permission-set
- app.bsky.authFullApp permission-set
- app.bsky.authManageFeedDeclarations permission-set
- app.bsky.authManageLabelerService permission-set
- app.bsky.authManageModeration permission-set
- app.bsky.authManageNotifications permission-set
- app.bsky.authManageProfile permission-set
- app.bsky.authViewAll permission-set
- app.bsky.actor.contentVisibilityDeclaration record A declaration of an account's preferences for appearing in content discovery surfaces.
- app.bsky.actor.defs defs If set, an active progress guide. Once completed, can be set to undefined. Should have unspecced fields tracking progress.
- app.bsky.actor.getPreferences query 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 query Get detailed profile view of an actor. Does not require auth, but contains relevant metadata with auth.
- app.bsky.actor.getProfiles query Get detailed profile views of multiple actors.
- app.bsky.actor.getSuggestions query Get a list of suggested actors. Expected use is discovery of accounts to follow during new account onboarding.
- app.bsky.actor.link record A link shown on the account's profile. The profile record's links field sets which links are shown, and in what order.
- app.bsky.actor.profile record A declaration of a Bluesky account profile.
- app.bsky.actor.putPreferences procedure Set the private preferences attached to the account.
- app.bsky.actor.searchActors query Find actors (profiles) matching search criteria. Does not require auth.
- app.bsky.actor.searchActorsTypeahead query 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.status record A declaration of a Bluesky account status.
- app.bsky.ageassurance.begin procedure Initiate Age Assurance for an account.
- app.bsky.ageassurance.defs defs The access level granted based on Age Assurance data we've processed.
- app.bsky.ageassurance.getConfig query Returns Age Assurance configuration for use on the client.
- app.bsky.ageassurance.getState query Returns server-computed Age Assurance state, if available, and any additional metadata needed to compute Age Assurance state client-side.
- app.bsky.bookmark.createBookmark procedure Creates a private bookmark for the specified record. Currently, only `app.bsky.feed.post` records are supported. Requires authentication.
- app.bsky.bookmark.defs defs Object used to store bookmark data in stash.
- app.bsky.bookmark.deleteBookmark procedure Deletes a private bookmark for the specified record. Currently, only `app.bsky.feed.post` records are supported. Requires authentication.
- app.bsky.bookmark.getBookmarks query Gets views of records bookmarked by the authenticated user. Requires authentication.
- app.bsky.contact.defs defs Associates a profile with the positional index of the contact import input in the call to `app.bsky.contact.importContacts`, so clients can know which phone caused a particular match.
- app.bsky.contact.dismissMatch procedure Removes a match that was found via contact import. It shouldn't appear again if the same contact is re-imported. Requires authentication.
- app.bsky.contact.getMatches query Returns the matched contacts (contacts that were mutually imported). Excludes dismissed matches. Requires authentication.
- app.bsky.contact.getSyncStatus query Gets the user's current contact import status. Requires authentication.
- app.bsky.contact.importContacts procedure Import contacts for securely matching with other users. This follows the protocol explained in https://docs.bsky.app/blog/contact-import-rfc. Requires authentication.
- app.bsky.contact.removeData procedure Removes all stored hashes used for contact matching, existing matches, and sync status. Requires authentication.
- app.bsky.contact.sendNotification procedure System endpoint to send notifications related to contact imports. Requires role authentication.
- app.bsky.contact.startPhoneVerification procedure Starts a phone verification flow. The phone passed will receive a code via SMS that should be passed to `app.bsky.contact.verifyPhone`. Requires authentication.
- app.bsky.contact.verifyPhone procedure Verifies control over a phone number with a code received via SMS and starts a contact import session. Requires authentication.
- app.bsky.draft.createDraft procedure Inserts a draft using private storage (stash). An upper limit of drafts might be enforced. Requires authentication.
- app.bsky.draft.defs defs A draft containing an array of draft posts.
- app.bsky.draft.deleteDraft procedure Deletes a draft by ID. Requires authentication.
- app.bsky.draft.getDrafts query Gets views of user drafts. Requires authentication.
- app.bsky.draft.updateDraft procedure Updates a draft using private storage (stash). If the draft ID points to a non-existing ID, the update will be silently ignored. This is done because updates don't enforce draft limit, so it accepts all writes, but will ignore invalid ones. Requires authentication.
- app.bsky.embed.defs defs width:height represents an aspect ratio. It may be approximate, and may not correspond to absolute dimensions in any given unit.
- app.bsky.embed.external object A representation of some externally linked content (eg, a URL and 'card'), embedded in a Bluesky record (eg, a post).
- app.bsky.embed.gallery object An assortment of media embedded in a Bluesky record (eg, a post).
- app.bsky.embed.getEmbedExternalView query Resolve one AT-URI record into the data needed to render an enhanced external embed. The records are validated against the requested `url` before any view is built. When validation passes, returns `data`, `associatedRefs` (strongRefs to embed into a post's external.associatedRefs) and the raw `associatedRecords`, plus a legacy `view` for Standard.site records only. When validation fails, only `unverifiedAssociatedRefs` and `unverifiedAssociatedRecords` are returned and no view or data is built.
- app.bsky.embed.images object A set of images embedded in a Bluesky record (eg, a post).
- app.bsky.embed.record object A representation of a record embedded in a Bluesky record (eg, a post). For example, a quote-post, or sharing a feed generator record.
- app.bsky.embed.recordWithMedia object A representation of a record embedded in a Bluesky record (eg, a post), alongside other compatible embeds. For example, a quote post and image, or a quote post and external URL card.
- app.bsky.embed.video object A video embedded in a Bluesky record (eg, a post).
- app.bsky.feed.defs defs User clicked through to the author of the feed item
- app.bsky.feed.describeFeedGenerator query 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.generator record Record declaring of the existence of a feed generator, and containing metadata about it. The record can exist in any repository.
- app.bsky.feed.getActorFeeds query Get a list of feeds (feed generator records) created by the actor (in the actor's repo).
- app.bsky.feed.getActorLikes query Get a list of posts liked by an actor. Requires auth, actor must be the requesting account.
- app.bsky.feed.getAuthorFeed query Get a view of an actor's 'author feed' (post and reposts by the author). Does not require auth.
- app.bsky.feed.getFeed query Get a hydrated feed from an actor's selected feed generator. Implemented by App View.
- app.bsky.feed.getFeedGenerator query Get information about a feed generator. Implemented by AppView.
- app.bsky.feed.getFeedGenerators query Get information about a list of feed generators.
- app.bsky.feed.getFeedSkeleton query 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.getLikes query Get like records which reference a subject (by AT-URI and CID).
- app.bsky.feed.getListFeed query 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 query Get posts in a thread. Does not require auth, but additional metadata and filtering will be applied for authed requests.
- app.bsky.feed.getPosts query 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.getQuotes query Get a list of quotes for a given post.
- app.bsky.feed.getRepostedBy query Get a list of reposts for a given post.
- app.bsky.feed.getSuggestedFeeds query Get a list of suggested feeds (feed generators) for the requesting account.
- app.bsky.feed.getTimeline query Get a view of the requesting account's home timeline. This is expected to be some form of reverse-chronological feed.
- app.bsky.feed.like record Record declaring a 'like' of a piece of subject content.
- app.bsky.feed.post record Record containing a Bluesky post.
- app.bsky.feed.postgate record Record defining interaction rules for a post. The record key (rkey) of the postgate record must match the record key of the post, and that record must be in the same repository.
- app.bsky.feed.repost record Record representing a 'repost' of an existing Bluesky post.
- app.bsky.feed.searchPosts query Find posts matching search criteria, returning views of those posts. Note that this API endpoint may require authentication (eg, not public) for some service providers and implementations.
- app.bsky.feed.searchPostsV2 query Find posts matching a search query or filters, returning search hits for matching post records.
- app.bsky.feed.sendInteractions procedure Send information about interactions with feed items back to the feed generator that served them.
- app.bsky.feed.threadgate record Record defining interaction gating rules for a thread (aka, reply controls). The record key (rkey) of the threadgate record must match the record key of the thread's root post, and that record must be in the same repository.
- app.bsky.graph.block record Record declaring a 'block' relationship against another account. NOTE: blocks are public in Bluesky; see blog posts for details.
- app.bsky.graph.defs defs A list of actors used for curation purposes such as list feeds or interaction gating.
- app.bsky.graph.follow record Record declaring a social 'follow' relationship of another account. Duplicate follows will be ignored by the AppView.
- app.bsky.graph.getActorStarterPacks query Get a list of starter packs created by the actor.
- app.bsky.graph.getBlocks query Enumerates which accounts the requesting account is currently blocking. Requires auth.
- app.bsky.graph.getFollowers query Enumerates accounts which follow a specified account (actor).
- app.bsky.graph.getFollows query Enumerates accounts which a specified account (actor) follows.
- app.bsky.graph.getKnownFollowers query Enumerates accounts which follow a specified account (actor) and are followed by the viewer.
- app.bsky.graph.getList query Gets a 'view' (with additional context) of a specified list.
- app.bsky.graph.getListBlocks query Get mod lists that the requesting account (actor) is blocking. Requires auth.
- app.bsky.graph.getListMutes query Enumerates mod lists that the requesting account (actor) currently has muted. Requires auth.
- app.bsky.graph.getLists query Enumerates the lists created by a specified account (actor).
- app.bsky.graph.getListsWithMembership query Enumerates the lists created by the session user, and includes membership information about `actor` in those lists. Only supports curation and moderation lists (no reference lists, used in starter packs). Requires auth.
- app.bsky.graph.getMutes query Enumerates accounts that the requesting account (actor) currently has fully muted. Mutes scoped to specific kinds of content (only reposts, only quote posts) are not included. Responses may contain more items than the requested limit. Requires auth.
- app.bsky.graph.getRelationships query Enumerates public relationships between one account, and a list of other accounts. Does not require auth.
- app.bsky.graph.getStarterPack query Gets a view of a starter pack.
- app.bsky.graph.getStarterPacks query Get views for a list of starter packs.
- app.bsky.graph.getStarterPacksWithMembership query Enumerates the starter packs created by the session user, and includes membership information about `actor` in those starter packs. Requires auth.
- app.bsky.graph.getSuggestedFollowsByActor query Enumerates follows similar to a given account (actor). Expected use is to recommend additional accounts immediately after following one account.
- app.bsky.graph.list record Record representing a list of accounts (actors). Scope includes both moderation-oriented lists and curration-oriented lists.
- app.bsky.graph.listblock record Record representing a block relationship against an entire an entire list of accounts (actors).
- app.bsky.graph.listitem record Record representing an account's inclusion on a specific list. The AppView will ignore duplicate listitem records.
- app.bsky.graph.muteActor procedure Creates a mute relationship for the specified account. If a mute already exists for the account, it is updated in place: the stored scope is replaced with the scope in this request. Mutes are private in Bluesky. Requires auth.
- app.bsky.graph.muteActorList procedure Creates a mute relationship for the specified list of accounts. Mutes are private in Bluesky. Requires auth.
- app.bsky.graph.muteThread procedure Mutes a thread preventing notifications from the thread and any of its children. Mutes are private in Bluesky. Requires auth.
- app.bsky.graph.referencelistoptout record Record requesting that its author be omitted from the public presentation of a reference list. This record is only enforced when the subject list's current purpose is app.bsky.graph.defs#referencelist. AppView indexes at most one record per actor and list pair, and ignores duplicate records.
- app.bsky.graph.searchStarterPacks query Find starter packs matching search criteria. Does not require auth.
- app.bsky.graph.searchStarterPacksV2 query Find starter packs matching search criteria. Does not require auth.
- app.bsky.graph.starterpack record Record defining a starter pack of actors and feeds for new users.
- app.bsky.graph.unmuteActor procedure Unmutes the specified account. Requires auth.
- app.bsky.graph.unmuteActorList procedure Unmutes the specified list of accounts. Requires auth.
- app.bsky.graph.unmuteThread procedure Unmutes the specified thread. Requires auth.
- app.bsky.graph.verification record Record declaring a verification relationship between two accounts. Verifications are only considered valid by an app if issued by an account the app considers trusted.
- app.bsky.notification.declaration record A declaration of the user's choices related to notifications that can be produced by them.
- app.bsky.notification.defs defs Deprecated: use chat.bsky.notification preferences instead. This will only return a default value.
- app.bsky.notification.getGroupedNotifications query [UNSTABLE - DO NOT USE THIS ENDPOINT WHILE THIS NOTE IS HERE] Enumerate notifications for the requesting account, pre-grouped for rendering. Supersedes listNotifications. Requires auth.
- app.bsky.notification.getPreferences query Get notification-related preferences for an account. Requires auth.
- app.bsky.notification.getUnreadCount query Count the number of unread notifications for the requesting account. Requires auth.
- app.bsky.notification.listActivitySubscriptions query Enumerate all accounts to which the requesting account is subscribed to receive notifications for. Requires auth.
- app.bsky.notification.listNotifications query Enumerate notifications for the requesting account. Requires auth.
- app.bsky.notification.putActivitySubscription procedure Puts an activity subscription entry. The key should be omitted for creation and provided for updates. Requires auth.
- app.bsky.notification.putPreferences procedure Set notification-related preferences for an account. Requires auth.
- app.bsky.notification.putPreferencesV2 procedure Set notification-related preferences for an account. Requires auth.
- app.bsky.notification.registerPush procedure Register to receive push notifications, via a specified service, for the requesting account. Requires auth.
- app.bsky.notification.unregisterPush procedure The inverse of registerPush - inform a specified service that push notifications should no longer be sent to the given token for the requesting account. Requires auth.
- app.bsky.notification.updateSeen procedure Notify server that the requesting account has seen notifications. Requires auth.