At this level
town.delve · 9- town.delve.authCreatePosts permission-set not from the namespace authority
- town.delve.authDeleteContent permission-set not from the namespace authority
- town.delve.authFullApp permission-set not from the namespace authority
- town.delve.authManageFeedDeclarations permission-set not from the namespace authority
- town.delve.authManageLabelerService permission-set not from the namespace authority
- town.delve.authManageModeration permission-set not from the namespace authority
- town.delve.authManageNotifications permission-set not from the namespace authority
- town.delve.authManageProfile permission-set not from the namespace authority
- town.delve.authViewAll permission-set not from the namespace authority
- town.delve.actor.contentVisibilityDeclaration record not from the namespace authority A declaration of an account's preferences for appearing in content discovery surfaces.
- town.delve.actor.defs defs not from the namespace authority If set, an active progress guide. Once completed, can be set to undefined. Should have unspecced fields tracking progress.
- town.delve.actor.getPreferences query not from the namespace authority Get private preferences attached to the current account. Expected use is synchronization between multiple devices, and import/export during account migration. Requires auth.
- town.delve.actor.getProfile query not from the namespace authority Get detailed profile view of an actor. Does not require auth, but contains relevant metadata with auth.
- town.delve.actor.getProfiles query not from the namespace authority Get detailed profile views of multiple actors.
- town.delve.actor.getSuggestions query not from the namespace authority Get a list of suggested actors. Expected use is discovery of accounts to follow during new account onboarding.
- town.delve.actor.profile record not from the namespace authority A declaration of a Bluesky account profile.
- town.delve.actor.putPreferences procedure not from the namespace authority Set the private preferences attached to the account.
- town.delve.actor.searchActors query not from the namespace authority Find actors (profiles) matching search criteria. Does not require auth.
- town.delve.actor.searchActorsTypeahead query not from the namespace authority Find actor suggestions for a prefix search term. Expected use is for auto-completion during text field entry. Does not require auth.
- town.delve.actor.status record not from the namespace authority A declaration of a Bluesky account status.
- town.delve.ageassurance.begin procedure not from the namespace authority Initiate Age Assurance for an account.
- town.delve.ageassurance.defs defs not from the namespace authority The access level granted based on Age Assurance data we've processed.
- town.delve.ageassurance.getConfig query not from the namespace authority Returns Age Assurance configuration for use on the client.
- town.delve.ageassurance.getState query not from the namespace authority Returns server-computed Age Assurance state, if available, and any additional metadata needed to compute Age Assurance state client-side.
- town.delve.bookmark.createBookmark procedure not from the namespace authority Creates a private bookmark for the specified record. Currently, only `app.bsky.feed.post` records are supported. Requires authentication.
- town.delve.bookmark.defs defs not from the namespace authority Object used to store bookmark data in stash.
- town.delve.bookmark.deleteBookmark procedure not from the namespace authority Deletes a private bookmark for the specified record. Currently, only `app.bsky.feed.post` records are supported. Requires authentication.
- town.delve.bookmark.getBookmarks query not from the namespace authority Gets views of records bookmarked by the authenticated user. Requires authentication.
- town.delve.contact.defs defs not from the namespace authority 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.
- town.delve.contact.dismissMatch procedure not from the namespace authority Removes a match that was found via contact import. It shouldn't appear again if the same contact is re-imported. Requires authentication.
- town.delve.contact.getMatches query not from the namespace authority Returns the matched contacts (contacts that were mutually imported). Excludes dismissed matches. Requires authentication.
- town.delve.contact.getSyncStatus query not from the namespace authority Gets the user's current contact import status. Requires authentication.
- town.delve.contact.importContacts procedure not from the namespace authority Import contacts for securely matching with other users. This follows the protocol explained in https://docs.bsky.app/blog/contact-import-rfc. Requires authentication.
- town.delve.contact.removeData procedure not from the namespace authority Removes all stored hashes used for contact matching, existing matches, and sync status. Requires authentication.
- town.delve.contact.sendNotification procedure not from the namespace authority System endpoint to send notifications related to contact imports. Requires role authentication.
- town.delve.contact.startPhoneVerification procedure not from the namespace authority 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.
- town.delve.contact.verifyPhone procedure not from the namespace authority Verifies control over a phone number with a code received via SMS and starts a contact import session. Requires authentication.
- town.delve.draft.createDraft procedure not from the namespace authority Inserts a draft using private storage (stash). An upper limit of drafts might be enforced. Requires authentication.
- town.delve.draft.defs defs not from the namespace authority A draft containing an array of draft posts.
- town.delve.draft.deleteDraft procedure not from the namespace authority Deletes a draft by ID. Requires authentication.
- town.delve.draft.getDrafts query not from the namespace authority Gets views of user drafts. Requires authentication.
- town.delve.draft.updateDraft procedure not from the namespace authority 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.
- town.delve.embed.defs defs not from the namespace authority width:height represents an aspect ratio. It may be approximate, and may not correspond to absolute dimensions in any given unit.
- town.delve.embed.external object not from the namespace authority A representation of some externally linked content (eg, a URL and 'card'), embedded in a Bluesky record (eg, a post).
- town.delve.embed.gallery object not from the namespace authority An assortment of media embedded in a Bluesky record (eg, a post).
- town.delve.embed.getEmbedExternalView query not from the namespace authority Resolve one or more AT-URIs into the data needed to render an enhanced external embed. Returns `associatedRefs` (strongRefs to embed into a post's external.associatedRefs), the raw `associatedRecords`, and a hydrated `view`. The response is empty (`{}`) when no records were resolvable, or when validation determined the resolved records don't actually back the requested URL; clients should fall back to their own link-card rendering in that case and skip writing strongRefs to the post.
- town.delve.embed.images object not from the namespace authority A set of images embedded in a Bluesky record (eg, a post).
- town.delve.embed.record object not from the namespace authority A representation of a record embedded in a Bluesky record (eg, a post). For example, a quote-post, or sharing a feed generator record.
- town.delve.embed.recordWithMedia object not from the namespace authority 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.
- town.delve.embed.video object not from the namespace authority A video embedded in a Bluesky record (eg, a post).
- town.delve.feed.defs defs not from the namespace authority User clicked through to the author of the feed item
- town.delve.feed.describeFeedGenerator query not from the namespace authority Get information about a feed generator, including policies and offered feed URIs. Does not require auth; implemented by Feed Generator services (not App View).
- town.delve.feed.generator record not from the namespace authority Record declaring of the existence of a feed generator, and containing metadata about it. The record can exist in any repository.
- town.delve.feed.getActorFeeds query not from the namespace authority Get a list of feeds (feed generator records) created by the actor (in the actor's repo).
- town.delve.feed.getActorLikes query not from the namespace authority Get a list of posts liked by an actor. Requires auth, actor must be the requesting account.
- town.delve.feed.getAuthorFeed query not from the namespace authority Get a view of an actor's 'author feed' (post and reposts by the author). Does not require auth.
- town.delve.feed.getFeed query not from the namespace authority Get a hydrated feed from an actor's selected feed generator. Implemented by App View.
- town.delve.feed.getFeedGenerator query not from the namespace authority Get information about a feed generator. Implemented by AppView.
- town.delve.feed.getFeedGenerators query not from the namespace authority Get information about a list of feed generators.
- town.delve.feed.getFeedSkeleton query not from the namespace authority 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.
- town.delve.feed.getLikes query not from the namespace authority Get like records which reference a subject (by AT-URI and CID).
- town.delve.feed.getListFeed query not from the namespace authority Get a feed of recent posts from a list (posts and reposts from any actors on the list). Does not require auth.
- town.delve.feed.getPostThread query not from the namespace authority Get posts in a thread. Does not require auth, but additional metadata and filtering will be applied for authed requests.
- town.delve.feed.getPosts query not from the namespace authority Gets post views for a specified list of posts (by AT-URI). This is sometimes referred to as 'hydrating' a 'feed skeleton'.
- town.delve.feed.getQuotes query not from the namespace authority Get a list of quotes for a given post.
- town.delve.feed.getRepostedBy query not from the namespace authority Get a list of reposts for a given post.
- town.delve.feed.getSuggestedFeeds query not from the namespace authority Get a list of suggested feeds (feed generators) for the requesting account.
- town.delve.feed.getTimeline query not from the namespace authority Get a view of the requesting account's home timeline. This is expected to be some form of reverse-chronological feed.
- town.delve.feed.like record not from the namespace authority Record declaring a 'like' of a piece of subject content.
- town.delve.feed.post record not from the namespace authority Record containing a Bluesky post.
- town.delve.feed.postgate record not from the namespace authority 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.
- town.delve.feed.repost record not from the namespace authority Record representing a 'repost' of an existing Bluesky post.
- town.delve.feed.searchPosts query not from the namespace authority 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.
- town.delve.feed.searchPostsV2 query not from the namespace authority Find posts matching a search query or filters, returning search hits for matching post records.
- town.delve.feed.sendInteractions procedure not from the namespace authority Send information about interactions with feed items back to the feed generator that served them.
- town.delve.feed.threadgate record not from the namespace authority 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.
- town.delve.graph.block record not from the namespace authority Record declaring a 'block' relationship against another account. NOTE: blocks are public in Bluesky; see blog posts for details.
- town.delve.graph.defs defs not from the namespace authority A list of actors used for curation purposes such as list feeds or interaction gating.
- town.delve.graph.follow record not from the namespace authority Record declaring a social 'follow' relationship of another account. Duplicate follows will be ignored by the AppView.
- town.delve.graph.getActorStarterPacks query not from the namespace authority Get a list of starter packs created by the actor.
- town.delve.graph.getBlocks query not from the namespace authority Enumerates which accounts the requesting account is currently blocking. Requires auth.
- town.delve.graph.getFollowers query not from the namespace authority Enumerates accounts which follow a specified account (actor).
- town.delve.graph.getFollows query not from the namespace authority Enumerates accounts which a specified account (actor) follows.
- town.delve.graph.getKnownFollowers query not from the namespace authority Enumerates accounts which follow a specified account (actor) and are followed by the viewer.
- town.delve.graph.getList query not from the namespace authority Gets a 'view' (with additional context) of a specified list.
- town.delve.graph.getListBlocks query not from the namespace authority Get mod lists that the requesting account (actor) is blocking. Requires auth.
- town.delve.graph.getListMutes query not from the namespace authority Enumerates mod lists that the requesting account (actor) currently has muted. Requires auth.
- town.delve.graph.getLists query not from the namespace authority Enumerates the lists created by a specified account (actor).
- town.delve.graph.getListsWithMembership query not from the namespace authority 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.
- town.delve.graph.getMutes query not from the namespace authority 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.
- town.delve.graph.getRelationships query not from the namespace authority Enumerates public relationships between one account, and a list of other accounts. Does not require auth.
- town.delve.graph.getStarterPack query not from the namespace authority Gets a view of a starter pack.
- town.delve.graph.getStarterPacks query not from the namespace authority Get views for a list of starter packs.
- town.delve.graph.getStarterPacksWithMembership query not from the namespace authority Enumerates the starter packs created by the session user, and includes membership information about `actor` in those starter packs. Requires auth.
- town.delve.graph.getSuggestedFollowsByActor query not from the namespace authority Enumerates follows similar to a given account (actor). Expected use is to recommend additional accounts immediately after following one account.
- town.delve.graph.list record not from the namespace authority Record representing a list of accounts (actors). Scope includes both moderation-oriented lists and curration-oriented lists.
- town.delve.graph.listblock record not from the namespace authority Record representing a block relationship against an entire an entire list of accounts (actors).
- town.delve.graph.listitem record not from the namespace authority Record representing an account's inclusion on a specific list. The AppView will ignore duplicate listitem records.
- town.delve.graph.muteActor procedure not from the namespace authority 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.
- town.delve.graph.muteActorList procedure not from the namespace authority Creates a mute relationship for the specified list of accounts. Mutes are private in Bluesky. Requires auth.
- town.delve.graph.muteThread procedure not from the namespace authority Mutes a thread preventing notifications from the thread and any of its children. Mutes are private in Bluesky. Requires auth.
- town.delve.graph.referencelistoptout record not from the namespace authority 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.
- town.delve.graph.searchStarterPacks query not from the namespace authority Find starter packs matching search criteria. Does not require auth.
- town.delve.graph.searchStarterPacksV2 query not from the namespace authority Find starter packs matching search criteria. Does not require auth.
- town.delve.graph.starterpack record not from the namespace authority Record defining a starter pack of actors and feeds for new users.
- town.delve.graph.unmuteActor procedure not from the namespace authority Unmutes the specified account. Requires auth.
- town.delve.graph.unmuteActorList procedure not from the namespace authority Unmutes the specified list of accounts. Requires auth.
- town.delve.graph.unmuteThread procedure not from the namespace authority Unmutes the specified thread. Requires auth.
- town.delve.graph.verification record not from the namespace authority 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.
- town.delve.membership.defs defs not from the namespace authority An account's standing in the town. Active members are indexed and served; withdrawn members keep what they posted but add nothing new; a suspended account is neither.
- town.delve.membership.getMembership query not from the namespace authority The requesting account's standing in the town. Requires auth.
- town.delve.membership.join procedure not from the namespace authority Join the town, or rejoin after withdrawing. An account hosted on the town's own PDS needs no code; any other account presents an invite code: either a town invite or a code a member took from Settings on the town's PDS, which the join then spends. Requires auth.
- town.delve.membership.withdraw procedure not from the namespace authority Leave the town. Existing posts stay; nothing new is indexed. Requires auth.
- town.delve.notification.declaration record not from the namespace authority A declaration of the user's choices related to notifications that can be produced by them.
- town.delve.notification.defs defs not from the namespace authority Deprecated: use chat.bsky.notification preferences instead. This will only return a default value.
- town.delve.notification.getPreferences query not from the namespace authority Get notification-related preferences for an account. Requires auth.
- town.delve.notification.getUnreadCount query not from the namespace authority Count the number of unread notifications for the requesting account. Requires auth.
- town.delve.notification.listActivitySubscriptions query not from the namespace authority Enumerate all accounts to which the requesting account is subscribed to receive notifications for. Requires auth.
- town.delve.notification.listNotifications query not from the namespace authority Enumerate notifications for the requesting account. Requires auth.
- town.delve.notification.putActivitySubscription procedure not from the namespace authority Puts an activity subscription entry. The key should be omitted for creation and provided for updates. Requires auth.
- town.delve.notification.putPreferences procedure not from the namespace authority Set notification-related preferences for an account. Requires auth.
- town.delve.notification.putPreferencesV2 procedure not from the namespace authority Set notification-related preferences for an account. Requires auth.
- town.delve.notification.registerPush procedure not from the namespace authority Register to receive push notifications, via a specified service, for the requesting account. Requires auth.
- town.delve.notification.unregisterPush procedure not from the namespace authority 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.
- town.delve.notification.updateSeen procedure not from the namespace authority Notify server that the requesting account has seen notifications. Requires auth.
- town.delve.unspecced.defs defs not from the namespace authority Object used to store age assurance data in stash.
- town.delve.unspecced.getAgeAssuranceState query not from the namespace authority Returns the current state of the age assurance process for an account. This is used to check if the user has completed age assurance or if further action is required.
- town.delve.unspecced.getConfig query not from the namespace authority Get miscellaneous runtime configuration.
- town.delve.unspecced.getOnboardingSuggestedStarterPacks query not from the namespace authority Get a list of suggested starterpacks for onboarding
- town.delve.unspecced.getOnboardingSuggestedStarterPacksSkeleton query not from the namespace authority Get a skeleton of suggested starterpacks for onboarding. Intended to be called and hydrated by app.bsky.unspecced.getOnboardingSuggestedStarterPacks
- town.delve.unspecced.getOnboardingSuggestedUsersSkeleton query not from the namespace authority Get a skeleton of suggested users for onboarding. Intended to be called and hydrated by app.bsky.unspecced.getSuggestedOnboardingUsers
- town.delve.unspecced.getPopularFeedGenerators query not from the namespace authority An unspecced view of globally popular feed generators.
- town.delve.unspecced.getPostThreadOtherV2 query not from the namespace authority (NOTE: this endpoint is under development and WILL change without notice. Don't use it until it is moved out of `unspecced` or your application WILL break) Get additional posts under a thread e.g. replies hidden by threadgate. Based on an anchor post at any depth of the tree, returns top-level replies below that anchor. It does not include ancestors nor the anchor itself. This should be called after exhausting `app.bsky.unspecced.getPostThreadV2`. Does not require auth, but additional metadata a
- town.delve.unspecced.getPostThreadV2 query not from the namespace authority (NOTE: this endpoint is under development and WILL change without notice. Don't use it until it is moved out of `unspecced` or your application WILL break) Get posts in a thread. It is based in an anchor post at any depth of the tree, and returns posts above it (recursively resolving the parent, without further branching to their replies) and below it (recursive replies, with branching to their replies). Does not require auth, but additional metadata and filtering will be applied for authed requ
- town.delve.unspecced.getSuggestedFeeds query not from the namespace authority Get a list of suggested feeds
- town.delve.unspecced.getSuggestedFeedsSkeleton query not from the namespace authority Get a skeleton of suggested feeds. Intended to be called and hydrated by app.bsky.unspecced.getSuggestedFeeds
- town.delve.unspecced.getSuggestedOnboardingUsers query not from the namespace authority Get a list of suggested users for onboarding
- town.delve.unspecced.getSuggestedStarterPacks query not from the namespace authority Get a list of suggested starterpacks
- town.delve.unspecced.getSuggestedStarterPacksSkeleton query not from the namespace authority Get a skeleton of suggested starterpacks. Intended to be called and hydrated by app.bsky.unspecced.getSuggestedStarterpacks
- town.delve.unspecced.getSuggestedUsers query not from the namespace authority Get a list of suggested users
- town.delve.unspecced.getSuggestedUsersForDiscover query not from the namespace authority Get a list of suggested users for the Discover page
- town.delve.unspecced.getSuggestedUsersForDiscoverSkeleton query not from the namespace authority Get a skeleton of suggested users for the Discover page. Intended to be called and hydrated by app.bsky.unspecced.getSuggestedUsersForDiscover
- town.delve.unspecced.getSuggestedUsersForExplore query not from the namespace authority Get a list of suggested users for the Explore page
- town.delve.unspecced.getSuggestedUsersForExploreSkeleton query not from the namespace authority Get a skeleton of suggested users for the Explore page. Intended to be called and hydrated by app.bsky.unspecced.getSuggestedUsersForExplore
- town.delve.unspecced.getSuggestedUsersForSeeMore query not from the namespace authority Get a list of suggested users for the See More page
- town.delve.unspecced.getSuggestedUsersForSeeMoreSkeleton query not from the namespace authority Get a skeleton of suggested users for the See More page. Intended to be called and hydrated by app.bsky.unspecced.getSuggestedUsersForSeeMore
- town.delve.unspecced.getSuggestedUsersSkeleton query not from the namespace authority Get a skeleton of suggested users. Intended to be called and hydrated by app.bsky.unspecced.getSuggestedUsers
- town.delve.unspecced.getSuggestionsSkeleton query not from the namespace authority Get a skeleton of suggested actors. Intended to be called and then hydrated through app.bsky.actor.getSuggestions
- town.delve.unspecced.getTaggedSuggestions query not from the namespace authority Get a list of suggestions (feeds and users) tagged with categories
- town.delve.unspecced.getTrendingTopics query not from the namespace authority Get a list of trending topics
- town.delve.unspecced.getTrends query not from the namespace authority Get the current trends on the network
- town.delve.unspecced.getTrendsSkeleton query not from the namespace authority Get the skeleton of trends on the network. Intended to be called and then hydrated through app.bsky.unspecced.getTrends
- town.delve.unspecced.initAgeAssurance procedure not from the namespace authority Initiate age assurance for an account. This is a one-time action that will start the process of verifying the user's age.
- town.delve.unspecced.searchActorsSkeleton query not from the namespace authority Backend Actors (profile) search, returns only skeleton.
- town.delve.unspecced.searchPostsSkeleton query not from the namespace authority Backend Posts search, returns only skeleton
- town.delve.unspecced.searchStarterPacksSkeleton query not from the namespace authority Backend Starter Pack search, returns only skeleton.
- town.delve.video.abortUpload procedure not from the namespace authority Abort an upload only while it is created, releasing its quota reservation immediately. Terminal sessions are unchanged and return their terminal outcome. A finishing session returns UploadNotReady.
- town.delve.video.defs defs not from the namespace authority
- town.delve.video.finishUpload procedure not from the namespace authority Finish an upload. This call is idempotent and safe to retry. On deduplication completedJobId may differ from the input jobId; poll getJobStatus with completedJobId. Probe-based validation failures surface later as JOB_STATE_FAILED from getJobStatus, not as errors from this call.
- town.delve.video.getJobStatus query not from the namespace authority Get status details for a video processing job.
- town.delve.video.getUploadLimits query not from the namespace authority Get video upload limits for the authenticated user.
- town.delve.video.getUploadStatus query not from the namespace authority Get the authoritative status of the upload phase. Terminal states remain readable. completedJobId and jobStatus are present only for completed sessions; failureReason is present only for failed sessions.
- town.delve.video.startUpload procedure not from the namespace authority Start a multipart video upload. The declared size is exact, while optional media properties are advisory and used only for early failure; the authoritative probe runs asynchronously after upload.
- town.delve.video.uploadPart procedure not from the namespace authority Upload one part. Parts are idempotent and may be retried or re-sent while the session is created. Each expected length is derived from the upload size and part size, and Content-Length must match exactly. ETags are never exposed to clients.
- town.delve.video.uploadVideo procedure not from the namespace authority Upload a video to be processed then stored on the PDS.