Skip to main content
Every bluesky.api.* operation is listed below with parameter shapes and return types from the plugin Zod schemas.
New to Corsair? See API access, authentication, and error handling.

​
Feeds

​
getTimeline

feeds.getTimeline Get the home timeline feed of the authenticated user Risk: read 
await corsair.bluesky.api.feeds.getTimeline({});
Input
NameTypeRequiredDescription
algorithmstringNoAlgorithm to use for the feed
limitnumberNoMaximum number of items to return (1-100)
cursorstringNoPagination cursor
Output
NameTypeRequiredDescription
feedobject[]Yes—
cursorstringNo—
{
  post: {
    uri: string,
    cid: string,
    author: {
      did: string,
      handle: string,
      displayName?: string,
      avatar?: string
    },
    record: {
      text: string,
      createdAt: string
    },
    replyCount?: number,
    repostCount?: number,
    likeCount?: number
  }
}[]

​
Posts

​
create

posts.create Create/publish a new post (skeet) on Bluesky Risk: write 
await corsair.bluesky.api.posts.create({});
Input
NameTypeRequiredDescription
textstringYesThe text content of the post (max 300 characters)
Output
NameTypeRequiredDescription
uristringYes—
cidstringYes—

​
deleteRecord

posts.deleteRecord Delete a post on Bluesky [DESTRUCTIVE] Risk: destructive · Irreversible 
await corsair.bluesky.api.posts.deleteRecord({});
Input
NameTypeRequiredDescription
uristringYesThe AT Protocol URI (at://did:plc:…) of the post to delete
Output
NameTypeRequiredDescription
successbooleanYes—

​
Profiles

​
get

profiles.get Get profile information for a Bluesky actor/user Risk: read 
await corsair.bluesky.api.profiles.get({});
Input
NameTypeRequiredDescription
actorstringYesThe handle or DID of the user profile to fetch
Output
NameTypeRequiredDescription
didstringYes—
handlestringYes—
displayNamestringNo—
descriptionstringNo—
avatarstringNo—
bannerstringNo—
followersCountnumberNo—
followsCountnumberNo—
postsCountnumberNo—