Bluesky MCP server for AI agents

Let Claude, ChatGPT or your own agent read and act on Bluesky: 70 typed functions through one MCP server. No Bluesky API key needed.

Functions
70
Sign-in
For account actions
Works with
MCP, HTTP, Node, Python

Connect

Just Bluesky

An MCP server for Bluesky alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.

https://api.bowmark.ai/mcp/site/bluesky
Every site

One MCP server for Bluesky and every other site Bowmark covers. Your agent looks up what it needs and calls it.

https://api.bowmark.ai/mcp
Set it up in your client

Both need a Bowmark API key. The quickstart gets you one and a first result in a few minutes. Functions that need a login use the person's own account: how sign-in works.

Functions

Open a function to see its arguments, what it returns and how to call it.

Read 42
  • getConversationThe messages in one of the caller's DM conversations, page by page, with a finder from a person's handle.

    Arguments

    NameTypeRequired
    conversationIdstringNo
    withstringNo
    limitnumberNo
    cursorstringNo

    Returns BlueskyConversationMessages

    interface BlueskyChatMessage {
      id: string;
      text: string;
      senderDid: string;
      sentAt: string;
      deleted: boolean;
    }
    
    interface BlueskyConversationMessages {
      conversationId: string;
      messages: BlueskyChatMessage[];
      cursor?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/getConversation

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.getConversation({ with: "bsky.app" });
  • getFeedRead a custom feed's posts (Discover, What's Hot, any creator's feed) by URL or at:// URI, page by page.

    Arguments

    NameTypeRequired
    feedstring | { feed: string; limit?: number; cursor?: string }Yes

    Returns BlueskyFeed

    interface BlueskyPostAuthor {
      did: string;
      handle: string;
      displayName: string | null;
      avatar: string | null;
    }
    
    interface BlueskyPostEmbed {
      kind: "images" | "external" | "video" | "quote" | null;
      images?: { thumb: string; fullsize: string; alt: string }[];
      external?: { uri: string; title: string; description: string; thumb: string | null };
      video?: { thumbnail: string | null; alt: string | null };
      quotedPost?: string | null;
    }
    
    interface BlueskyPost {
      uri: string;
      cid: string;
      author: BlueskyPostAuthor;
      text: string;
      createdAt: string;
      likeCount: number;
      replyCount: number;
      repostCount: number;
      quoteCount: number;
      bookmarkCount: number;
      embed: BlueskyPostEmbed | null;
      isRepost: boolean;
      repostedBy: string | null;
    }
    
    interface BlueskyFeed {
      posts: BlueskyPost[];
      cursor?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/getFeed

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.getFeed("at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.generator/whats-hot");
  • getFeedInfoOne custom feed's details: name, creator, description, avatar, like count and whether it is online.

    Arguments

    NameTypeRequired
    feedstring | { feed: string }Yes

    Returns BlueskyFeedInfo

    interface BlueskyPostAuthor {
      did: string;
      handle: string;
      displayName: string | null;
      avatar: string | null;
    }
    
    interface BlueskyFeedInfo {
      uri: string;
      name: string;
      creator: BlueskyPostAuthor;
      description: string | null;
      avatar: string | null;
      likeCount: number;
      indexedAt: string | null;
      isOnline: boolean;
      isValid: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/getFeedInfo

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.getFeedInfo("at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.generator/whats-hot");
  • getFollowersWho follows a person, page by page.

    Arguments

    NameTypeRequired
    actorstring | { actor: string; limit?: number; cursor?: string }Yes

    Returns BlueskyFollowersResults

    interface BlueskyPostAuthor {
      did: string;
      handle: string;
      displayName: string | null;
      avatar: string | null;
    }
    
    interface BlueskyFollowersResults {
      followers: BlueskyPostAuthor[];
      subject: BlueskyPostAuthor;
      cursor?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/getFollowers

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.getFollowers("bsky.app");
  • getFollowsWho a person follows, page by page.

    Arguments

    NameTypeRequired
    actorstring | { actor: string; limit?: number; cursor?: string }Yes

    Returns BlueskyFollowsResults

    interface BlueskyPostAuthor {
      did: string;
      handle: string;
      displayName: string | null;
      avatar: string | null;
    }
    
    interface BlueskyFollowsResults {
      follows: BlueskyPostAuthor[];
      subject: BlueskyPostAuthor;
      cursor?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/getFollows

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.getFollows("bsky.app");
  • getKnownFollowersWhich of the caller's own follows also follow a given person.

    Arguments

    NameTypeRequired
    actorstring | { actor: string; limit?: number; cursor?: string }Yes

    Returns BlueskyKnownFollowers

    interface BlueskyPostAuthor {
      did: string;
      handle: string;
      displayName: string | null;
      avatar: string | null;
    }
    
    interface BlueskyKnownFollowers {
      followers: BlueskyPostAuthor[];
      subject: BlueskyPostAuthor;
      cursor?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/getKnownFollowers

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.getKnownFollowers("bsky.app");
  • getLabelersA moderation service's (labeler's) details and the labels it applies.

    Arguments

    NameTypeRequired
    didsstring | string[] | { dids: string | string[]; detailed?: boolean }Yes

    Returns BlueskyLabelersResults

    interface BlueskyPostAuthor {
      did: string;
      handle: string;
      displayName: string | null;
      avatar: string | null;
    }
    
    interface BlueskyLabelDefinition {
      identifier: string;
      severity: string;
      defaultSetting: string;
      adultOnly: boolean;
      name: string;
      description: string;
    }
    
    interface BlueskyLabelerView {
      uri: string;
      creator: BlueskyPostAuthor;
      likeCount: number;
      policies: BlueskyLabelDefinition[] | null;
    }
    
    interface BlueskyLabelersResults {
      labelers: BlueskyLabelerView[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/getLabelers

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.getLabelers({ dids: ["did:plc:ar7c4by46qjdydhdevvrndac"] });
  • getListA list's details and members, page by page.

    Arguments

    NameTypeRequired
    liststring | { list: string; limit?: number; cursor?: string }Yes

    Returns BlueskyListResult

    interface BlueskyPostAuthor {
      did: string;
      handle: string;
      displayName: string | null;
      avatar: string | null;
    }
    
    interface BlueskyUserList {
      uri: string;
      name: string;
      purpose: "curate" | "moderation" | "unknown";
      itemCount: number;
      description: string | null;
      creator: BlueskyPostAuthor;
    }
    
    interface BlueskyListMember {
      uri: string;
      member: BlueskyPostAuthor;
    }
    
    interface BlueskyListResult {
      list: BlueskyUserList;
      members: BlueskyListMember[];
      cursor?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/getList

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.getList("at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.graph.list/3lvpca43j5z26");
  • getListFeedThe posts from everyone on a curation list, as the list's own feed tab shows them.

    Arguments

    NameTypeRequired
    liststring | { list: string; limit?: number; cursor?: string }Yes

    Returns BlueskyListFeedResult

    interface BlueskyPostAuthor {
      did: string;
      handle: string;
      displayName: string | null;
      avatar: string | null;
    }
    
    interface BlueskyPostEmbed {
      kind: "images" | "external" | "video" | "quote" | null;
      images?: { thumb: string; fullsize: string; alt: string }[];
      external?: { uri: string; title: string; description: string; thumb: string | null };
      video?: { thumbnail: string | null; alt: string | null };
      quotedPost?: string | null;
    }
    
    interface BlueskyPost {
      uri: string;
      cid: string;
      author: BlueskyPostAuthor;
      text: string;
      createdAt: string;
      likeCount: number;
      replyCount: number;
      repostCount: number;
      quoteCount: number;
      bookmarkCount: number;
      embed: BlueskyPostEmbed | null;
      isRepost: boolean;
      repostedBy: string | null;
    }
    
    interface BlueskyListFeedResult {
      posts: BlueskyPost[];
      cursor?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/getListFeed

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.getListFeed("at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.graph.list/3lvpca43j5z26");
  • getMeWho the signed-in caller is: their DID, handle, email-confirmed flag and PDS host.

    Arguments

    None.

    Returns BlueskyMe

    interface BlueskyMe {
      did: string;
      handle: string;
      email: string | null;
      emailConfirmed: boolean;
      active: boolean;
      pds: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/getMe

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.getMe();
  • getMyLikesThe posts the caller has liked.

    Arguments

    NameTypeRequired
    opts{ limit?: number; cursor?: string }No

    Returns BlueskySignedInPostPage

    interface BlueskyPostAuthor {
      did: string;
      handle: string;
      displayName: string | null;
      avatar: string | null;
    }
    
    interface BlueskyPostEmbed {
      kind: "images" | "external" | "video" | "quote" | null;
      images?: { thumb: string; fullsize: string; alt: string }[];
      external?: { uri: string; title: string; description: string; thumb: string | null };
      video?: { thumbnail: string | null; alt: string | null };
      quotedPost?: string | null;
    }
    
    interface BlueskyPost {
      uri: string;
      cid: string;
      author: BlueskyPostAuthor;
      text: string;
      createdAt: string;
      likeCount: number;
      replyCount: number;
      repostCount: number;
      quoteCount: number;
      bookmarkCount: number;
      embed: BlueskyPostEmbed | null;
      isRepost: boolean;
      repostedBy: string | null;
    }
    
    interface BlueskySignedInPostPage {
      posts: BlueskyPost[];
      cursor?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/getMyLikes

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.getMyLikes();
  • getPostOne post by URL (bsky.app/profile/<handle>/post/<rkey>) or at:// URI: text, author, embeds, reply/repost/like/quote counts.

    Arguments

    NameTypeRequired
    poststringYes

    Returns BlueskyGetPostResult

    interface BlueskyPostAuthor {
      did: string;
      handle: string;
      displayName: string | null;
      avatar: string | null;
    }
    
    interface BlueskyPostEmbed {
      kind: "images" | "external" | "video" | "quote" | null;
      images?: { thumb: string; fullsize: string; alt: string }[];
      external?: { uri: string; title: string; description: string; thumb: string | null };
      video?: { thumbnail: string | null; alt: string | null };
      quotedPost?: string | null;
    }
    
    interface BlueskyPost {
      uri: string;
      cid: string;
      author: BlueskyPostAuthor;
      text: string;
      createdAt: string;
      likeCount: number;
      replyCount: number;
      repostCount: number;
      quoteCount: number;
      bookmarkCount: number;
      embed: BlueskyPostEmbed | null;
      isRepost: boolean;
      repostedBy: string | null;
    }
    
    type BlueskyGetPostResult = BlueskyPost;

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/getPost

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.getPost("at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3myi2ihquwk26");
  • getPostLikesWho liked a post, page by page.

    Arguments

    NameTypeRequired
    poststring | { post: string; limit?: number; cursor?: string }Yes

    Returns BlueskyPostLikesResults

    interface BlueskyPostAuthor {
      did: string;
      handle: string;
      displayName: string | null;
      avatar: string | null;
    }
    
    interface BlueskyPostLike {
      actor: BlueskyPostAuthor;
      indexedAt: string;
    }
    
    interface BlueskyPostLikesResults {
      likes: BlueskyPostLike[];
      cursor?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/getPostLikes

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.getPostLikes("at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3myi2ihquwk26");
  • getPostQuotesThe posts that quote a given post, page by page.

    Arguments

    NameTypeRequired
    poststring | { post: string; limit?: number; cursor?: string }Yes

    Returns BlueskyPostQuotesResults

    interface BlueskyPostAuthor {
      did: string;
      handle: string;
      displayName: string | null;
      avatar: string | null;
    }
    
    interface BlueskyPostEmbed {
      kind: "images" | "external" | "video" | "quote" | null;
      images?: { thumb: string; fullsize: string; alt: string }[];
      external?: { uri: string; title: string; description: string; thumb: string | null };
      video?: { thumbnail: string | null; alt: string | null };
      quotedPost?: string | null;
    }
    
    interface BlueskyPost {
      uri: string;
      cid: string;
      author: BlueskyPostAuthor;
      text: string;
      createdAt: string;
      likeCount: number;
      replyCount: number;
      repostCount: number;
      quoteCount: number;
      bookmarkCount: number;
      embed: BlueskyPostEmbed | null;
      isRepost: boolean;
      repostedBy: string | null;
    }
    
    interface BlueskyPostQuotesResults {
      posts: BlueskyPost[];
      cursor?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/getPostQuotes

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.getPostQuotes("at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3mw2cdr44fc2a");
  • getPostRepostsWho reposted a post, page by page.

    Arguments

    NameTypeRequired
    poststring | { post: string; limit?: number; cursor?: string }Yes

    Returns BlueskyPostRepostsResults

    interface BlueskyPostAuthor {
      did: string;
      handle: string;
      displayName: string | null;
      avatar: string | null;
    }
    
    interface BlueskyPostRepostsResults {
      reposters: BlueskyPostAuthor[];
      cursor?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/getPostReposts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.getPostReposts("at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3mw2cdr44fc2a");
  • getProfileOne person's profile: display name, handle, bio, avatar, banner, follower/following/post counts, pinned post and labels.

    Arguments

    NameTypeRequired
    actorstringYes

    Returns BlueskyProfile

    interface BlueskyProfile {
      did: string;
      handle: string;
      displayName: string | null;
      bio: string | null;
      avatar: string | null;
      banner: string | null;
      followersCount: number;
      followsCount: number;
      postsCount: number;
      pinnedPost: string | null;
      labels: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/getProfile

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.getProfile("bsky.app");
  • getRelationshipsWhether one account follows, or is followed by, each of a list of others.

    Arguments

    NameTypeRequired
    args{ actor: string; others: string | string[] }Yes

    Returns BlueskyRelationshipsResults

    interface BlueskyRelationship {
      did: string;
      following: string | null;
      followedBy: string | null;
    }
    
    interface BlueskyRelationshipsResults {
      actor: string;
      relationships: BlueskyRelationship[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/getRelationships

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.getRelationships({ actor: "bsky.app", others: "jay.bsky.team" });
  • getStarterPackOne starter pack: its creator, description, the accounts and feeds it bundles, and how many joined through it.

    Arguments

    NameTypeRequired
    starterPackstring | { starterPack: string }Yes

    Returns BlueskyStarterPackResult

    interface BlueskyPostAuthor {
      did: string;
      handle: string;
      displayName: string | null;
      avatar: string | null;
    }
    
    interface BlueskyListMember {
      uri: string;
      member: BlueskyPostAuthor;
    }
    
    interface BlueskyStarterPackResult {
      uri: string;
      name: string;
      description: string | null;
      list: string | null;
      joinedAllTimeCount: number;
      joinedWeekCount: number;
      creator: BlueskyPostAuthor;
      memberSample: BlueskyListMember[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/getStarterPack

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.getStarterPack("at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.graph.starterpack/3mv3qhvnmkd2l");
  • getSuggestedFeedsBluesky's own suggested custom feeds.

    Arguments

    NameTypeRequired
    options{ limit?: number }No

    Returns BlueskySuggestedFeedsResults

    interface BlueskyPostAuthor {
      did: string;
      handle: string;
      displayName: string | null;
      avatar: string | null;
    }
    
    interface BlueskySuggestedFeedResult {
      uri: string;
      name: string;
      creator: BlueskyPostAuthor;
      description: string | null;
      likeCount: number;
    }
    
    interface BlueskySuggestedFeedsResults {
      feeds: BlueskySuggestedFeedResult[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/getSuggestedFeeds

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.getSuggestedFeeds();
  • getSuggestedFollowsAccounts Bluesky suggests alongside a given person.

    Arguments

    NameTypeRequired
    actorstringYes

    Returns BlueskySuggestedFollowsResults

    interface BlueskyPostAuthor {
      did: string;
      handle: string;
      displayName: string | null;
      avatar: string | null;
    }
    
    interface BlueskySuggestedFollowsResults {
      suggestions: BlueskyPostAuthor[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/getSuggestedFollows

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.getSuggestedFollows("bsky.app");
  • getSuggestedUsersBluesky's own suggested accounts to follow, as shown during onboarding.

    Arguments

    NameTypeRequired
    options{ limit?: number }No

    Returns BlueskySuggestedUsersResults

    interface BlueskyPostAuthor {
      did: string;
      handle: string;
      displayName: string | null;
      avatar: string | null;
    }
    
    interface BlueskySuggestedUsersResults {
      users: BlueskyPostAuthor[];
      count: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/getSuggestedUsers

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.getSuggestedUsers();
  • getThreadA post with its whole conversation: the parents above it and the reply tree below it, as the post page shows it.

    Arguments

    NameTypeRequired
    poststringYes

    Returns BlueskyGetThreadResult

    interface BlueskyPostAuthor {
      did: string;
      handle: string;
      displayName: string | null;
      avatar: string | null;
    }
    
    interface BlueskyPostEmbed {
      kind: "images" | "external" | "video" | "quote" | null;
      images?: { thumb: string; fullsize: string; alt: string }[];
      external?: { uri: string; title: string; description: string; thumb: string | null };
      video?: { thumbnail: string | null; alt: string | null };
      quotedPost?: string | null;
    }
    
    interface BlueskyPost {
      uri: string;
      cid: string;
      author: BlueskyPostAuthor;
      text: string;
      createdAt: string;
      likeCount: number;
      replyCount: number;
      repostCount: number;
      quoteCount: number;
      bookmarkCount: number;
      embed: BlueskyPostEmbed | null;
      isRepost: boolean;
      repostedBy: string | null;
    }
    
    interface BlueskyGetThreadResult {
      root: BlueskyPost;
      parents: BlueskyPost[];
      replies: BlueskyPost[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/getThread

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.getThread("at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3mw2cdr44fc2a");
  • getTimelineThe caller's home Following feed, newest first, page by page.

    Arguments

    NameTypeRequired
    opts{ limit?: number; cursor?: string }No

    Returns BlueskySignedInPostPage

    interface BlueskyPostAuthor {
      did: string;
      handle: string;
      displayName: string | null;
      avatar: string | null;
    }
    
    interface BlueskyPostEmbed {
      kind: "images" | "external" | "video" | "quote" | null;
      images?: { thumb: string; fullsize: string; alt: string }[];
      external?: { uri: string; title: string; description: string; thumb: string | null };
      video?: { thumbnail: string | null; alt: string | null };
      quotedPost?: string | null;
    }
    
    interface BlueskyPost {
      uri: string;
      cid: string;
      author: BlueskyPostAuthor;
      text: string;
      createdAt: string;
      likeCount: number;
      replyCount: number;
      repostCount: number;
      quoteCount: number;
      bookmarkCount: number;
      embed: BlueskyPostEmbed | null;
      isRepost: boolean;
      repostedBy: string | null;
    }
    
    interface BlueskySignedInPostPage {
      posts: BlueskyPost[];
      cursor?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/getTimeline

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.getTimeline();
  • getTrendingTopicsWhat is trending on Bluesky right now: the topics and the links to their search or feed pages.

    Arguments

    None.

    Returns BlueskyTrendingTopicsResults

    interface BlueskyTrendingTopic {
      link: string;
      description: string;
      topic: string;
      displayName: string;
    }
    
    interface BlueskyTrendingTopicsResults {
      topics: BlueskyTrendingTopic[];
      suggested?: string[];
      cursor?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/getTrendingTopics

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.getTrendingTopics();
  • getTrendsThe richer trending list the Explore page shows: each trend's post count, status (hot/new) and category.

    Arguments

    None.

    Returns BlueskyTrendsResults

    interface BlueskyTrend {
      value: string;
      count: number;
      status: string;  // the site's own labels, read the values off a result, never guess one from prose
      category?: string;
    }
    
    interface BlueskyTrendsResults {
      trends: BlueskyTrend[];
      cursor?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/getTrends

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.getTrends();
  • getUserFeedsThe custom feeds a person has made.

    Arguments

    NameTypeRequired
    actorstring | { actor: string; limit?: number; cursor?: string }Yes

    Returns BlueskyUserFeedsResults

    interface BlueskyPostAuthor {
      did: string;
      handle: string;
      displayName: string | null;
      avatar: string | null;
    }
    
    interface BlueskyUserFeed {
      uri: string;
      name: string;
      creator: BlueskyPostAuthor;
      description: string | null;
      likeCount: number;
    }
    
    interface BlueskyUserFeedsResults {
      feeds: BlueskyUserFeed[];
      cursor?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/getUserFeeds

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.getUserFeeds("bsky.app");
  • getUserListsThe lists (curation and moderation lists) a person has made.

    Arguments

    NameTypeRequired
    actorstring | { actor: string; limit?: number; cursor?: string }Yes

    Returns BlueskyUserListsResults

    interface BlueskyPostAuthor {
      did: string;
      handle: string;
      displayName: string | null;
      avatar: string | null;
    }
    
    interface BlueskyUserList {
      uri: string;
      name: string;
      purpose: "curate" | "moderation" | "unknown";
      itemCount: number;
      description: string | null;
      creator: BlueskyPostAuthor;
    }
    
    interface BlueskyUserListsResults {
      lists: BlueskyUserList[];
      cursor?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/getUserLists

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.getUserLists("bsky.app");
  • getUserPostsA person's posts, newest first, as their profile tabs show them.

    Arguments

    NameTypeRequired
    actorstring | { actor: string; filter?: "posts" | "postsWithReplies" | "media" | "videos"; limit?: number; cursor?: string }Yes

    Returns BlueskyUserPosts

    interface BlueskyPostAuthor {
      did: string;
      handle: string;
      displayName: string | null;
      avatar: string | null;
    }
    
    interface BlueskyPostEmbed {
      kind: "images" | "external" | "video" | "quote" | null;
      images?: { thumb: string; fullsize: string; alt: string }[];
      external?: { uri: string; title: string; description: string; thumb: string | null };
      video?: { thumbnail: string | null; alt: string | null };
      quotedPost?: string | null;
    }
    
    interface BlueskyPost {
      uri: string;
      cid: string;
      author: BlueskyPostAuthor;
      text: string;
      createdAt: string;
      likeCount: number;
      replyCount: number;
      repostCount: number;
      quoteCount: number;
      bookmarkCount: number;
      embed: BlueskyPostEmbed | null;
      isRepost: boolean;
      repostedBy: string | null;
    }
    
    interface BlueskyUserPosts {
      posts: BlueskyPost[];
      cursor?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/getUserPosts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.getUserPosts("bsky.app");
  • getUserStarterPacksThe starter packs a person has made.

    Arguments

    NameTypeRequired
    actorstring | { actor: string; limit?: number; cursor?: string }Yes

    Returns BlueskyUserStarterPacksResults

    interface BlueskyPostAuthor {
      did: string;
      handle: string;
      displayName: string | null;
      avatar: string | null;
    }
    
    interface BlueskyUserStarterPack {
      uri: string;
      name: string;
      description: string | null;
      list: string | null;
      joinedAllTimeCount: number;
      joinedWeekCount: number;
      creator: BlueskyPostAuthor;
    }
    
    interface BlueskyUserStarterPacksResults {
      starterPacks: BlueskyUserStarterPack[];
      cursor?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/getUserStarterPacks

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.getUserStarterPacks("bsky.app");
  • listBlockedUsersThe accounts the caller has blocked.

    Arguments

    NameTypeRequired
    opts{ limit?: number; cursor?: string }No

    Returns BlueskySignedInUserPage

    interface BlueskyPostAuthor {
      did: string;
      handle: string;
      displayName: string | null;
      avatar: string | null;
    }
    
    interface BlueskySignedInUserPage {
      users: BlueskyPostAuthor[];
      cursor?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/listBlockedUsers

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.listBlockedUsers();
  • listBookmarksThe posts the caller has saved to Bookmarks.

    Arguments

    NameTypeRequired
    opts{ limit?: number; cursor?: string }No

    Returns BlueskyBookmarkPage

    interface BlueskyPostAuthor {
      did: string;
      handle: string;
      displayName: string | null;
      avatar: string | null;
    }
    
    interface BlueskyPostEmbed {
      kind: "images" | "external" | "video" | "quote" | null;
      images?: { thumb: string; fullsize: string; alt: string }[];
      external?: { uri: string; title: string; description: string; thumb: string | null };
      video?: { thumbnail: string | null; alt: string | null };
      quotedPost?: string | null;
    }
    
    interface BlueskyPost {
      uri: string;
      cid: string;
      author: BlueskyPostAuthor;
      text: string;
      createdAt: string;
      likeCount: number;
      replyCount: number;
      repostCount: number;
      quoteCount: number;
      bookmarkCount: number;
      embed: BlueskyPostEmbed | null;
      isRepost: boolean;
      repostedBy: string | null;
    }
    
    interface BlueskyBookmark {
      savedAt: string;
      post: BlueskyPost;
    }
    
    interface BlueskyBookmarkPage {
      bookmarks: BlueskyBookmark[];
      cursor?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/listBookmarks

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.listBookmarks();
  • listConversationsThe caller's direct-message conversations, most recent first, with the last message and unread count.

    Arguments

    NameTypeRequired
    opts{ limit?: number; cursor?: string }No

    Returns BlueskyConversationPage

    interface BlueskyPostAuthor {
      did: string;
      handle: string;
      displayName: string | null;
      avatar: string | null;
    }
    
    interface BlueskyChatMessage {
      id: string;
      text: string;
      senderDid: string;
      sentAt: string;
      deleted: boolean;
    }
    
    interface BlueskyConversation {
      id: string;
      members: BlueskyPostAuthor[];
      lastMessage: BlueskyChatMessage | null;
      unreadCount: number;
      muted: boolean;
      status: string | null;  // the site's own labels, read the values off a result, never guess one from prose
    }
    
    interface BlueskyConversationPage {
      conversations: BlueskyConversation[];
      cursor?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/listConversations

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.listConversations();
  • listModerationListsOne page of the moderation lists the signed-in caller subscribes to: kind: "mute" (the default) for the lists they mute, kind: "block" for the lists…

    Arguments

    NameTypeRequired
    opts{ kind?: "mute" | "block"; limit?: number; cursor?: string }No

    Returns BlueskyModerationListPage

    interface BlueskyPostAuthor {
      did: string;
      handle: string;
      displayName: string | null;
      avatar: string | null;
    }
    
    interface BlueskyUserList {
      uri: string;
      name: string;
      purpose: "curate" | "moderation" | "unknown";
      itemCount: number;
      description: string | null;
      creator: BlueskyPostAuthor;
    }
    
    interface BlueskyModerationListPage {
      kind: "mute" | "block";
      lists: BlueskyUserList[];
      cursor?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/listModerationLists

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.listModerationLists();
  • listMutedUsersThe accounts the caller has muted.

    Arguments

    NameTypeRequired
    opts{ limit?: number; cursor?: string }No

    Returns BlueskySignedInUserPage

    interface BlueskyPostAuthor {
      did: string;
      handle: string;
      displayName: string | null;
      avatar: string | null;
    }
    
    interface BlueskySignedInUserPage {
      users: BlueskyPostAuthor[];
      cursor?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/listMutedUsers

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.listMutedUsers();
  • listMutedWordsList the words and tags the caller has muted.

    Arguments

    None.

    Returns BlueskyMutedWordList

    interface BlueskyMutedWord {
      id: string | null;
      value: string;
      targets: string[];
      excludeFollowing: boolean;
      expiresAt: string | null;
    }
    
    interface BlueskyMutedWordList {
      words: BlueskyMutedWord[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/listMutedWords

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.listMutedWords();
  • listNotificationsThe caller's notifications.

    Arguments

    NameTypeRequired
    opts{ limit?: number; cursor?: string }No

    Returns BlueskyNotificationPage

    interface BlueskyPostAuthor {
      did: string;
      handle: string;
      displayName: string | null;
      avatar: string | null;
    }
    
    interface BlueskyNotification {
      uri: string;
      reason: string;
      reasonSubject: string | null;
      author: BlueskyPostAuthor;
      text: string;
      isRead: boolean;
      indexedAt: string;
    }
    
    interface BlueskyNotificationPage {
      notifications: BlueskyNotification[];
      cursor?: string;
      seenAt: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/listNotifications

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.listNotifications();
  • resolveHandleTurn a Bluesky handle (alice.bsky.social, or a custom domain handle) into its permanent DID, the id every other function accepts.

    Arguments

    NameTypeRequired
    actorstringYes

    Returns BlueskyResolvedHandle

    interface BlueskyResolvedHandle {
      did: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/resolveHandle

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.resolveHandle("bsky.app");
  • searchFeedsFind custom feeds by words (e.g. 'science', 'art'), the way Explore's feed search does; returns each feed's URI, name, creator, description and like…

    Arguments

    NameTypeRequired
    querystring | { query: string; limit?: number; cursor?: string }Yes

    Returns BlueskySearchFeedsResults

    interface BlueskyPostAuthor {
      did: string;
      handle: string;
      displayName: string | null;
      avatar: string | null;
    }
    
    interface BlueskySearchFeedResult {
      uri: string;
      name: string;
      creator: BlueskyPostAuthor;
      description: string | null;
      likeCount: number;
    }
    
    interface BlueskySearchFeedsResults {
      feeds: BlueskySearchFeedResult[];
      cursor?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/searchFeeds

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.searchFeeds("science");
  • searchPostsSearch all public posts by words, with the Search tab's Top/Latest sort and its author, mention, language, domain and date filters.

    Arguments

    NameTypeRequired
    querystring | { query: string; sort?: "top" | "latest"; author?: string; mentions?: string; lang?: string; domain?: string; since?: string; until?: string; limit?: number; cursor?: string }Yes

    Returns BlueskySearchPostsResults

    interface BlueskyPostAuthor {
      did: string;
      handle: string;
      displayName: string | null;
      avatar: string | null;
    }
    
    interface BlueskyPostEmbed {
      kind: "images" | "external" | "video" | "quote" | null;
      images?: { thumb: string; fullsize: string; alt: string }[];
      external?: { uri: string; title: string; description: string; thumb: string | null };
      video?: { thumbnail: string | null; alt: string | null };
      quotedPost?: string | null;
    }
    
    interface BlueskyPost {
      uri: string;
      cid: string;
      author: BlueskyPostAuthor;
      text: string;
      createdAt: string;
      likeCount: number;
      replyCount: number;
      repostCount: number;
      quoteCount: number;
      bookmarkCount: number;
      embed: BlueskyPostEmbed | null;
      isRepost: boolean;
      repostedBy: string | null;
    }
    
    interface BlueskySearchPostsResults {
      posts: BlueskyPost[];
      cursor?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/searchPosts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.searchPosts("bluesky");
  • searchStarterPacksFind starter packs by words.

    Arguments

    NameTypeRequired
    querystring | { query: string; limit?: number; cursor?: string }Yes

    Returns BlueskyStarterPackSearchResults

    interface BlueskyPostAuthor {
      did: string;
      handle: string;
      displayName: string | null;
      avatar: string | null;
    }
    
    interface BlueskyUserStarterPack {
      uri: string;
      name: string;
      description: string | null;
      list: string | null;
      joinedAllTimeCount: number;
      joinedWeekCount: number;
      creator: BlueskyPostAuthor;
    }
    
    interface BlueskyStarterPackSearchResults {
      starterPacks: BlueskyUserStarterPack[];
      cursor?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/searchStarterPacks

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.searchStarterPacks({ query: "science" });
  • searchUsersSearch people by name, handle or bio words, the way the Search tab's People list does; returns handle, DID, display name, avatar and bio per match.

    Arguments

    NameTypeRequired
    querystring | { query: string; limit?: number; cursor?: string }Yes

    Returns BlueskyUserSearchResults

    interface BlueskyUserResult {
      did: string;
      handle: string;
      displayName: string | null;
      avatar: string | null;
      bio: string | null;
    }
    
    interface BlueskyUserSearchResults {
      users: BlueskyUserResult[];
      cursor?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/searchUsers

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.searchUsers("bluesky");
  • suggestUsersHandle autocomplete: the few accounts that best match a partial name, as the compose box's @-mention picker shows them.

    Arguments

    NameTypeRequired
    querystring | { query: string; limit?: number }Yes

    Returns BlueskySuggestUsersResults

    interface BlueskySuggestedUser {
      did: string;
      handle: string;
      displayName: string | null;
      avatar: string | null;
      bio: string | null;
    }
    
    interface BlueskySuggestUsersResults {
      users: BlueskySuggestedUser[];
      count: number; // users.length
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/suggestUsers

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.suggestUsers("blue");
Act 28
  • addToListAdd a person to one of the caller's lists, or remove them.

    Arguments

    NameTypeRequired
    liststringYes
    actorstringYes
    undobooleanNo

    Returns BlueskyPostActionResult

    interface BlueskyPostActionResult {
      uri: string | null;
      changed: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/addToList

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.addToList({ list: "<list>", actor: "<actor>" });
  • blockModerationListBlocks a moderation list for the signed-in caller, so every account on it is blocked from interacting with them; undo: true unblocks it.

    Arguments

    NameTypeRequired
    liststringYes
    undobooleanNo

    Returns BlueskyModerationListBlockResult

    interface BlueskyModerationListBlockResult {
      list: string;
      blocked: boolean;
      changed: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/blockModerationList

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.blockModerationList({ list: "<list>" });
  • blockUserBlock a person as the caller, or unblock them.

    Arguments

    NameTypeRequired
    actorstringYes
    undobooleanNo

    Returns BlueskyPostActionResult

    interface BlueskyPostActionResult {
      uri: string | null;
      changed: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/blockUser

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.blockUser({ actor: "<actor>" });
  • bookmarkPostSave a post to the caller's Bookmarks, or remove it.

    Arguments

    NameTypeRequired
    poststringYes
    undobooleanNo

    Returns BlueskyPostActionResult

    interface BlueskyPostActionResult {
      uri: string | null;
      changed: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/bookmarkPost

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.bookmarkPost({ post: "<post>" });
  • createListCreate a curation or moderation list owned by the caller.

    Arguments

    NameTypeRequired
    namestringYes
    descriptionstringNo
    purpose"curate" | "moderate"No

    Returns BlueskyCreatedRecord

    interface BlueskyCreatedRecord {
      uri: string;
      cid: string;
      url: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/createList

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.createList({ name: "<name>" });
  • createPostPublish a post as the caller: text with links and mentions resolved into facets, optional language tags.

    Arguments

    NameTypeRequired
    textstringYes
    langsstring[]No

    Returns BlueskyCreatedRecord

    interface BlueskyCreatedRecord {
      uri: string;
      cid: string;
      url: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/createPost

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.createPost({ text: "<text>" });
  • createPostWithImagesPublish a post with up to four images and their alt text.

    Arguments

    NameTypeRequired
    textstringNo
    imagesBlueskyPostImage[]Yes
    langsstring[]No

    Returns BlueskyCreatedRecord

    interface BlueskyCreatedRecord {
      uri: string;
      cid: string;
      url: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/createPostWithImages

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.createPostWithImages({ images: [] });
  • createPostWithVideoPosts one video, with optional text, alt text and languages.

    Arguments

    NameTypeRequired
    textstringNo
    videostringYes
    altstringNo
    langsstring[]No

    Returns BlueskyCreatedRecord

    interface BlueskyCreatedRecord {
      uri: string;
      cid: string;
      url: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/createPostWithVideo

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.createPostWithVideo({ video: "<video>" });
  • deleteListDelete one of the caller's own lists.

    Arguments

    NameTypeRequired
    liststringYes

    Returns BlueskyPostActionResult

    interface BlueskyPostActionResult {
      uri: string | null;
      changed: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/deleteList

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.deleteList({ list: "<list>" });
  • deletePostDelete one of the caller's own posts.

    Arguments

    NameTypeRequired
    poststringYes

    Returns BlueskyPostActionResult

    interface BlueskyPostActionResult {
      uri: string | null;
      changed: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/deletePost

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.deletePost("<post>");
  • followUserFollow a person as the caller, or unfollow them.

    Arguments

    NameTypeRequired
    actorstringYes
    undobooleanNo

    Returns BlueskyPostActionResult

    interface BlueskyPostActionResult {
      uri: string | null;
      changed: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/followUser

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.followUser({ actor: "<actor>" });
  • leaveConversationLeaves a conversation for the signed-in caller, so it stops being among their chats.

    Arguments

    NameTypeRequired
    conversationIdstringYes

    Returns BlueskyLeftConversation

    interface BlueskyLeftConversation {
      conversationId: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/leaveConversation

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.leaveConversation({ conversationId: "<conversationId>" });
  • likePostLike a post as the caller, or undo the like.

    Arguments

    NameTypeRequired
    poststringYes
    undobooleanNo

    Returns BlueskyPostActionResult

    interface BlueskyPostActionResult {
      uri: string | null;
      changed: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/likePost

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.likePost({ post: "<post>" });
  • markNotificationsReadMark the caller's notifications as seen up to now.

    Arguments

    NameTypeRequired
    opts{ seenAt?: string }No

    Returns BlueskyMarkSeenResult

    interface BlueskyMarkSeenResult {
      seenAt: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/markNotificationsRead

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.markNotificationsRead();
  • muteConversationMutes a direct or group chat for the signed-in caller, so its new messages stop notifying them; undo: true unmutes it.

    Arguments

    NameTypeRequired
    conversationIdstringNo
    withstringNo
    undobooleanNo

    Returns BlueskyConversationMuteResult

    interface BlueskyConversationMuteResult {
      conversationId: string;
      muted: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/muteConversation

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.muteConversation({});
  • muteModerationListMutes a moderation list for the signed-in caller, so the accounts on it are hidden from their feeds and notifications; undo: true unmutes it.

    Arguments

    NameTypeRequired
    liststringYes
    undobooleanNo

    Returns BlueskyModerationListMuteResult

    interface BlueskyModerationListMuteResult {
      list: string;
      muted: boolean;
      changed: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/muteModerationList

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.muteModerationList({ list: "<list>" });
  • muteThreadMutes a thread for the signed-in caller, so its replies stop reaching their notifications, as the app's Mute thread does.

    Arguments

    NameTypeRequired
    poststringYes
    undobooleanNo

    Returns BlueskyThreadMuteResult

    interface BlueskyThreadMuteResult {
      root: string;
      muted: boolean;
      changed: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/muteThread

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.muteThread({ post: "<post>" });
  • muteUserMute a person for the caller, or unmute them.

    Arguments

    NameTypeRequired
    actorstringYes
    undobooleanNo

    Returns BlueskyPostActionResult

    interface BlueskyPostActionResult {
      uri: string | null;
      changed: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/muteUser

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.muteUser({ actor: "<actor>" });
  • muteWordMute a word or tag so matching posts are hidden, or unmute it.

    Arguments

    NameTypeRequired
    wordstringYes
    targets("content" | "tag")[]No
    excludeFollowingbooleanNo
    expiresAtstringNo
    undobooleanNo

    Returns BlueskyMuteWordResult

    interface BlueskyMuteWordResult {
      word: string;
      muted: boolean;
      changed: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/muteWord

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.muteWord({ word: "<word>" });
  • pinPostPin one of the caller's own posts to the top of their profile, or unpin it.

    Arguments

    NameTypeRequired
    poststringYes
    undobooleanNo

    Returns BlueskyPostActionResult

    interface BlueskyPostActionResult {
      uri: string | null;
      changed: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/pinPost

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.pinPost({ post: "<post>" });
  • quotePostQuote-post an existing post with the caller's own text.

    Arguments

    NameTypeRequired
    poststringYes
    textstringYes
    langsstring[]No

    Returns BlueskyCreatedRecord

    interface BlueskyCreatedRecord {
      uri: string;
      cid: string;
      url: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/quotePost

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.quotePost({ post: "<post>", text: "<text>" });
  • replyToPostReply to a post as the caller, threaded under it.

    Arguments

    NameTypeRequired
    poststringYes
    textstringYes
    langsstring[]No

    Returns BlueskyCreatedRecord

    interface BlueskyCreatedRecord {
      uri: string;
      cid: string;
      url: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/replyToPost

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.replyToPost({ post: "<post>", text: "<text>" });
  • repostRepost a post as the caller, or undo the repost.

    Arguments

    NameTypeRequired
    poststringYes
    undobooleanNo

    Returns BlueskyPostActionResult

    interface BlueskyPostActionResult {
      uri: string | null;
      changed: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/repost

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.repost({ post: "<post>" });
  • saveFeedSave or pin a custom feed to the caller's feed list, or remove it.

    Arguments

    NameTypeRequired
    feedstringYes
    pinnedbooleanNo
    undobooleanNo

    Returns BlueskySaveFeedResult

    interface BlueskySaveFeedResult {
      feed: string;
      saved: boolean;
      pinned: boolean;
      changed: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/saveFeed

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.saveFeed({ feed: "<feed>" });
  • sendMessageSend a direct message as the caller to a person who accepts DMs from them.

    Arguments

    NameTypeRequired
    tostringNo
    conversationIdstringNo
    textstringYes

    Returns BlueskySentMessage

    interface BlueskyChatMessage {
      id: string;
      text: string;
      senderDid: string;
      sentAt: string;
      deleted: boolean;
    }
    
    interface BlueskySentMessage {
      conversationId: string;
      message: BlueskyChatMessage;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/sendMessage

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.sendMessage({ text: "<text>" });
  • setAvatarChange the caller's profile picture (or banner) from an image.

    Arguments

    NameTypeRequired
    imagestringYes
    bannerbooleanNo

    Returns BlueskyPostActionResult

    interface BlueskyPostActionResult {
      uri: string | null;
      changed: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/setAvatar

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.setAvatar({ image: "<image>" });
  • setReplyRestrictionSets who may reply to one of the caller's own thread-root posts: allow: "everyone" lifts the restriction, "nobody" closes replies, and a list of up…

    Arguments

    NameTypeRequired
    poststringYes
    allow"everyone" | "nobody" | BlueskyReplyRule[]Yes

    Returns BlueskyReplyRestrictionResult

    type BlueskyReplyRule = "mentioned" | "followers" | "following" | `at://${string}`;
    
    interface BlueskyReplyRestrictionResult {
      post: string;
      allow: "everyone" | "nobody" | BlueskyReplyRule[];
      changed: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/setReplyRestriction

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.setReplyRestriction({ post: "<post>", allow: "everyone" });
  • updateProfileChange the caller's display name and bio.

    Arguments

    NameTypeRequired
    displayNamestringNo
    biostringNo

    Returns BlueskyPostActionResult

    interface BlueskyPostActionResult {
      uri: string | null;
      changed: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bluesky/updateProfile

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bluesky.updateProfile({});

Use it from code