bsky.app

Search Bluesky posts by keyword/query using app.bsky.feed.searchPosts, with sort order, filters, and cursor pagination.

Read a Bluesky account's home timeline and a specific author's post feed, using cursor-based pagination and filter parameters, and know which of the two requires authentication.

Resolve a Bluesky handle to its DID and fetch that account's profile, understanding when to use a DID versus a handle in subsequent API calls.

Follow another Bluesky account, like a post, and repost a post, then undo each of those three actions by deleting the corresponding record.

Follow another Bluesky account, like a post, and repost a post, then undo each of those three actions by deleting the corresponding record.

Reply to an existing Bluesky post, correctly setting both the 'root' and 'parent' strong references so the reply threads correctly even in deep reply chains.

Attach an external website link card (social card preview) to a Bluesky post using app.bsky.embed.external, including an uploaded thumbnail image blob.

Attach one or more images (with alt text and aspect ratio) to a Bluesky post by uploading each image as a blob and embedding it via app.bsky.embed.images.

Add rich-text facets to a Bluesky post so URLs render as links, @handles render as mentions (and notify the user), and #tags render as hashtags.

Create a plain text post on Bluesky (no images, links, or replies) using com.atproto.repo.createRecord with an app.bsky.feed.post record.

Authenticate an AI agent to the Bluesky API using a handle and app password, obtain accessJwt/refreshJwt, and refresh the session when the access token expires.