Xrpc
Functions
Activates a currently deactivated account. Used to finalize account migration after the account's repo is imported and identity is setup.
Apply a batch transaction of repository creates, updates, and deletes. Requires auth, implemented by PDS.
Returns the status of an account, especially as pertaining to import or recovery. Can be called many times over the course of an account migration. Requires auth and can only be called pertaining to oneself.
Check accounts location in signup queue.
Confirm an email using a token from com.atproto.server.requestEmailConfirmation.
Create an account. Implemented by PDS.
Create an App Password.
Create an invite code.
Create invite codes.
Create a single new repository record. Requires auth, implemented by PDS.
Submit a moderation report regarding an atproto account or record. Implemented by moderation services (with PDS proxying), and requires auth.
Create an authentication session.
Administrative action to create a new, re-usable communication (email for now) template.
Deactivates a currently active account. Stops serving of repo, and future writes to repo until reactivated. Used to finalize account migration with the old host after the account has been activated on the new host.
Delete a user account as an administrator.
Delete an actor's account with a token and password. Can only be called after requesting a deletion token. Requires auth.
Delete a repository record, or ensure it doesn't exist. Requires auth, implemented by PDS.
Delete the current session. Requires auth.
Delete a communication template.
Get information about a feed generator, including policies and offered feed URIs. Does not require auth; implemented by Feed Generator services (not App View).
Get information about an account and repository, including the list of collections. Does not require auth.
Describes the server's account creation requirements and capabilities. Implemented by PDS.
Disable an account from receiving new invite codes, but does not invalidate existing codes.
Disable some set of codes and/or all codes associated with a set of users.
Take a moderation action on an actor.
Re-enable an account's ability to receive invite codes.
Get details about an account.
Get details about some accounts.
Get all invite codes for the current account. Requires auth.
Get a list of feeds (feed generator records) created by the actor (in the actor's repo).
Get a list of posts liked by an actor. Does not require auth.
Get a view of an actor's 'author feed' (post and reposts by the author). Does not require auth.
Get a blob associated with a given account. Returns the full blob as originally uploaded. Does not require auth; implemented by PDS.
Enumerates which accounts the requesting account is currently blocking. Requires auth.
Get data blocks from a given repo, by CID. For example, intermediate MST nodes, or records. Does not require auth; implemented by PDS.
Get details about a moderation event.
Get a hydrated feed from an actor's selected feed generator. Implemented by App View.
Get information about a feed generator. Implemented by AppView.
Get information about a list of feed generators.
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.
Enumerates accounts which follow a specified account (actor).
Enumerates accounts which a specified account (actor) follows.
Get an admin view of invite codes.
Get the current commit CID & revision of the specified repo. Does not require auth.
Get like records which reference a subject (by AT-URI and CID).
Gets a 'view' (with additional context) of a specified list.
Get mod lists that the requesting account (actor) is blocking. Requires auth.
Get a feed of recent posts from a list (posts and reposts from any actors on the list). Does not require auth.
Enumerates mod lists that the requesting account (actor) currently has muted. Requires auth.
Enumerates the lists created by a specified account (actor).
Enumerates accounts that the requesting account (actor) currently has muted. Requires auth.
An unspecced view of globally popular feed generators.
Gets post views for a specified list of posts (by AT-URI). This is sometimes referred to as 'hydrating' a 'feed skeleton'.
Get posts in a thread. Does not require auth, but additional metadata and filtering will be applied for authed requests.
Get private preferences attached to the current account. Expected use is synchronization between multiple devices, and import/export during account migration. Requires auth.
Get detailed profile view of an actor. Does not require auth, but contains relevant metadata with auth.
Get detailed profile views of multiple actors.
Describe the credentials that should be included in the DID doc of an account that is migrating to this service.
Get a single record from a repository. Does not require auth.
Get data blocks needed to prove the existence or non-existence of record in the current version of repo. Does not require auth.
Get details about a record.
Enumerates public relationships between one account, and a list of other accounts. Does not require auth.
Download a repository export as CAR file. Optionally only a 'diff' since a previous revision. Does not require auth; implemented by PDS.
Get details about a repository.
Get a list of reposts for a given post.
Get a signed token on behalf of the requesting DID for the requested service.
Get information about a list of labeler services.
Get information about the current auth session. Requires auth.
Get the service-specific admin status of a subject (account, record, or blob).
Get a list of suggested feeds (feed generators) for the requesting account.
Enumerates follows similar to a given account (actor). Expected use is to recommend additional accounts immediately after following one account.
Get a list of suggested actors. Expected use is discovery of accounts to follow during new account onboarding.
Get a skeleton of suggested actors. Intended to be called and then hydrated through app.bsky.actor.getSuggestions
Get a list of suggestions (feeds and users) tagged with categories
Get a view of the requesting account's home timeline. This is expected to be some form of reverse-chronological feed.
Count the number of unread notifications for the requesting account. Requires auth.
Import a repo in the form of a CAR file. Requires Content-Length HTTP header to be set.
List all App Passwords.
List blob CIDso for an account, since some repo revision. Does not require auth; implemented by PDS.
Returns a list of missing blobs for the requesting account. Intended to be used in the account migration flow.
Enumerate notifications for the requesting account. Requires auth.
List a range of records in a repository, matching a specific collection. Does not require auth.
Enumerates all the DID, rev, and commit CID for all repos hosted by this service. Does not require auth; implemented by PDS and Relay.
Get list of all communication templates.
Creates a mute relationship for the specified account. Mutes are private in Bluesky. Requires auth.
Creates a mute relationship for the specified list of accounts. Mutes are private in Bluesky. Requires auth.
Notify a crawling service of a recent update, and that crawling should resume. Intended use is after a gap between repo stream events caused the crawling service to disconnect. Does not require auth; implemented by Relay.
Set the private preferences attached to the account.
Write a repository record, creating or updating it as needed. Requires auth, implemented by PDS.
List moderation events related to a subject.
Find labels relevant to the provided AT-URI patterns. Public endpoint for moderation services, though may return different or additional results with auth.
View moderation statuses of subjects (record or repo).
Refresh an authentication session. Requires auth using the 'refreshJwt' (not the 'accessJwt').
Register to receive push notifications, via a specified service, for the requesting account. Requires auth.
Initiate a user account deletion via email.
Request a service to persistently crawl hosted repos. Expected use is new PDS instances declaring their existence to Relays. Does not require auth.
Request an email with a code to confirm ownership of email.
Request a token in order to update email.
Initiate a user account password reset via email.
Request a verification code to be sent to the supplied phone number
Request an email with a code to in order to request a signed PLC operation. Requires Auth.
Reserve a repo signing key, for use with account creation. Necessary so that a DID PLC update operation can be constructed during an account migraiton. Public and does not require auth; implemented by PDS. NOTE: this endpoint may change when full account migration is implemented.
Reset a user account password using a token.
Resolves a handle (domain name) to a DID.
Revoke an App Password by name.
Find actors (profiles) matching search criteria. Does not require auth.
Backend Actors (profile) search, returns only skeleton.
Find actor suggestions for a prefix search term. Expected use is for auto-completion during text field entry. Does not require auth.
Find posts matching search criteria, returning views of those posts.
Backend Posts search, returns only skeleton
Find repositories based on a search term.
Send email to a user's account email address.
Send information about interactions with feed items back to the feed generator that served them.
Signs a PLC operation to update some value(s) in the requesting DID's document.
Validates a PLC operation to ensure that it doesn't violate a service's constraints or get the identity into a bad state, then submits it to the PLC registry
Subscribe to stream of labels (and negations). Public endpoint implemented by mod services. Uses same sequencing scheme as repo event stream.
Repository event stream, aka Firehose endpoint. Outputs repo commits with diff data, and identity update events, for all repositories on the current server. See the atproto specifications for details around stream sequencing, repo versioning, CAR diff format, and more. Public and does not require auth; implemented by PDS and Relay.
Unmutes the specified account. Requires auth.
Unmutes the specified list of accounts. Requires auth.
Administrative action to update an account's email.
Administrative action to update an account's handle.
Update the password for a user account as an administrator.
Update an account's email.
Updates the current account's handle. Verifies handle validity, and updates did:plc document if necessary. Implemented by PDS, and requires auth.
Notify server that the requesting account has seen notifications. Requires auth.
Update the service-specific admin status of a subject (account, record, or blob).
Administrative action to update an existing communication template. Allows passing partial fields to patch specific fields only.
Upload a new blob, to be referenced from a repository record. The blob will be deleted if it is not referenced within a time window (eg, minutes). Blob restrictions (mimetype, size, etc) are enforced when the reference is created. Requires auth, implemented by PDS.