Skip to content
Docs

Typed Focus mode operations for Bluesky accounts, generated from the Bluesky focus module (same behaviour as the generic /accounts/{accountId}/focus routes).

Base URLhttps://api.socialit.com/v1AuthenticationErrorsRate limits168 endpointsMCP toolset focus_bluesky

Profile

Bluesky: Get Profile

GET/accounts/{accountId}/bluesky/profile

Current profile record and counters. Display name, bio, pronouns, website, avatar, banner, pinned post and account self-labels (bot, adult content, hide from logged-out viewers). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/profiles Generic route: /v1/accounts/{accountId}/focus/profile.

Access: read

Try it with MCPAsk your agent to call bluesky-profile-get (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

idstring

DID

didstring
handlestring
display_namestring | null

≤ 64 graphemes

≤ 640 characters

descriptionstring | null

≤ 256 graphemes

pronounsstring | null

≤ 20 graphemes

websitestring (uri) | null
avatar_urlstring (uri) | null
banner_urlstring (uri) | null
followers_countinteger
following_countinteger
posts_countinteger
pinned_poststring | null

AT-URI

self_labelsarray of string
verifiedboolean
created_atstring (date-time) | null
urlstring (uri)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/bluesky/profile
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/profile" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bluesky: Update Profile

PATCH/accounts/{accountId}/bluesky/profile

Edit the profile (read-modify-write; unknown fields are preserved). Display name, bio, pronouns, website, avatar, banner, pinned post and account self-labels (bot, adult content, hide from logged-out viewers). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/profiles Generic route: /v1/accounts/{accountId}/focus/profile.

Access: write

Try it with MCPAsk your agent to call bluesky-profile-update (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

display_namestring | null
descriptionstring | null
pronounsstring | null
websitestring (uri) | null
avatarstring

png/jpeg ≤ 1 MB (media id or URL)

bannerstring

png/jpeg ≤ 1 MB, 3:1

remove_avatarboolean
remove_bannerboolean
pinned_poststring | null

AT-URI or bsky.app URL; null unpins

self_labelsarray of string

Returns object

idstring

DID

didstring
handlestring
display_namestring | null

≤ 64 graphemes

≤ 640 characters

descriptionstring | null

≤ 256 graphemes

pronounsstring | null

≤ 20 graphemes

websitestring (uri) | null
avatar_urlstring (uri) | null
banner_urlstring (uri) | null
followers_countinteger
following_countinteger
posts_countinteger
pinned_poststring | null

AT-URI

self_labelsarray of string
verifiedboolean
created_atstring (date-time) | null
urlstring (uri)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/bluesky/profile
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/profile" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "display_name": "string",
    "description": "string",
    "pronouns": "string",
    "website": "https://example.com",
    "avatar": "string"
  }'
Response · 200

Bluesky: Pin post (Profile)

POST/accounts/{accountId}/bluesky/profile/pin-post

Pin post. Display name, bio, pronouns, website, avatar, banner, pinned post and account self-labels (bot, adult content, hide from logged-out viewers). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/profiles Generic route: /v1/accounts/{accountId}/focus/profile.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-profile-pin-post (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

uristringrequired

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/profile/pin-post
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/profile/pin-post" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "uri": "string"
  }'
Response · 200

Bluesky: Unpin post (Profile)

POST/accounts/{accountId}/bluesky/profile/unpin-post

Unpin post. Display name, bio, pronouns, website, avatar, banner, pinned post and account self-labels (bot, adult content, hide from logged-out viewers). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/profiles Generic route: /v1/accounts/{accountId}/focus/profile.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-profile-unpin-post (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/profile/unpin-post
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/profile/unpin-post" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Bluesky: Mark as automated (bot) (Profile)

POST/accounts/{accountId}/bluesky/profile/set-bot-label

Bluesky asks automated accounts to carry the bot self-label. Display name, bio, pronouns, website, avatar, banner, pinned post and account self-labels (bot, adult content, hide from logged-out viewers). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/profiles Generic route: /v1/accounts/{accountId}/focus/profile.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-profile-set-bot-label (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

enabledbooleanrequired

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/profile/set-bot-label
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/profile/set-bot-label" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "enabled": true
  }'
Response · 200

Account status

Bluesky: Get Account & handle

GET/accounts/{accountId}/bluesky/account-status

DID, PDS, auth mode, account status, email verification (required for video) and custom-domain handle. Requires one of: atproto. Network docs: https://endpoints.bsky.app/ Generic route: /v1/accounts/{accountId}/focus/account-status.

Access: read

Try it with MCPAsk your agent to call bluesky-account-status-get (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

didstring
handlestring
activeboolean
statusstring | null
emailstring | null
email_confirmedboolean | null
pds_urlstring (uri)
auth_modestring

oauthapp_password

granted_scopesarray of string

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/bluesky/account-status
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/account-status" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bluesky: Change handle (Account & handle)

POST/accounts/{accountId}/bluesky/account-status/update-handle

com.atproto.identity.updateHandle (10 per 5 min, 50 per day). DID, PDS, auth mode, account status, email verification (required for video) and custom-domain handle. Requires scopes: identity:handle. Requires one of: atproto. Network docs: https://endpoints.bsky.app/ Generic route: /v1/accounts/{accountId}/focus/account-status.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-account-status-update-handle (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

handlestringrequired

Domain with _atproto TXT or /.well-known/atproto-did already set up

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/account-status/update-handle
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/account-status/update-handle" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "handle": "string"
  }'
Response · 200

Discoverability

Bluesky: Get Discoverability

GET/accounts/{accountId}/bluesky/discoverability

Hide the account’s posts from algorithmic recommendations (app.bsky.actor.contentVisibilityDeclaration). Requires one of: repo:app.bsky.actor.contentVisibilityDeclaration | transition:generic. Network docs: https://bsky.network/docs/about-bluesky-content/visibility-preferences Generic route: /v1/accounts/{accountId}/focus/discoverability.

Access: read

Try it with MCPAsk your agent to call bluesky-discoverability-get (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

hide_from_algorithmic_recommendationsboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/bluesky/discoverability
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/discoverability" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bluesky: Update Discoverability

PATCH/accounts/{accountId}/bluesky/discoverability

Hide the account’s posts from algorithmic recommendations (app.bsky.actor.contentVisibilityDeclaration). Requires one of: repo:app.bsky.actor.contentVisibilityDeclaration | transition:generic. Network docs: https://bsky.network/docs/about-bluesky-content/visibility-preferences Generic route: /v1/accounts/{accountId}/focus/discoverability.

Access: write

Try it with MCPAsk your agent to call bluesky-discoverability-update (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

hide_from_algorithmic_recommendationsbooleanrequired

Returns object

hide_from_algorithmic_recommendationsboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/bluesky/discoverability
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/discoverability" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "hide_from_algorithmic_recommendations": true
  }'
Response · 200

Activity subscription policy

Bluesky: Get Who can subscribe

GET/accounts/{accountId}/bluesky/activity-subscription-policy

Who may get notified when the account posts (app.bsky.notification.declaration). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Network docs: https://endpoints.bsky.app/ Generic route: /v1/accounts/{accountId}/focus/activity-subscription-policy.

Access: read

Try it with MCPAsk your agent to call bluesky-activity-subscription-policy-get (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

allow_subscriptionsstring

followersmutualsnone

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/bluesky/activity-subscription-policy
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/activity-subscription-policy" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bluesky: Update Who can subscribe

PATCH/accounts/{accountId}/bluesky/activity-subscription-policy

Who may get notified when the account posts (app.bsky.notification.declaration). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Network docs: https://endpoints.bsky.app/ Generic route: /v1/accounts/{accountId}/focus/activity-subscription-policy.

Access: write

Try it with MCPAsk your agent to call bluesky-activity-subscription-policy-update (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

allow_subscriptionsstringrequired

followersmutualsnone

Returns object

allow_subscriptionsstring

followersmutualsnone

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/bluesky/activity-subscription-policy
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/activity-subscription-policy" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "allow_subscriptions": "followers"
  }'
Response · 200

Posting defaults

Bluesky: Get Posting defaults

GET/accounts/{accountId}/bluesky/posting-defaults

Socialit defaults for new posts: languages, reply/quote controls, content warnings, hidden tags, link cards and facet detection. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/posting-defaults.

Access: readZernio: GET /v1/accounts/{accountId}/bluesky-settings

Try it with MCPAsk your agent to call bluesky-posting-defaults-get (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

defaultLangsarray of string | null

Languages written to every new post (langs). null = unset (Bluesky guesses).

1–3 items

defaultThreadgatearray of string | null

Default reply controls. null = everyone can reply; [] = nobody; otherwise any of mentioned, followers, following, list:.

≤ 5 items

defaultPostgateobject | null

Default quote controls. null = quotes allowed.

Show 1 child attributes
disableQuotesboolean
defaultLabelsarray of string

Self-labels (content warnings) applied to every new post.

≤ 10 items

defaultTagsarray of string

Extra hidden hashtags (tags) added to every new post.

≤ 8 items

autoFacetsboolean

Detect links, @mentions and #hashtags (default true).

autoLinkCardsboolean

Build a link card from the first link when the post has no media (default true).

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/bluesky/posting-defaults
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/posting-defaults" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bluesky: Update Posting defaults

PATCH/accounts/{accountId}/bluesky/posting-defaults

Socialit defaults for new posts: languages, reply/quote controls, content warnings, hidden tags, link cards and facet detection. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/posting-defaults.

Access: writeZernio: PATCH /v1/accounts/{accountId}/bluesky-settings

Try it with MCPAsk your agent to call bluesky-posting-defaults-update (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

defaultLangsarray of string | null

Languages written to every new post (langs). null = unset (Bluesky guesses).

1–3 items

defaultThreadgatearray of string | null

Default reply controls. null = everyone can reply; [] = nobody; otherwise any of mentioned, followers, following, list:.

≤ 5 items

defaultPostgateobject | null

Default quote controls. null = quotes allowed.

Show 1 child attributes
disableQuotesboolean
defaultLabelsarray of string

Self-labels (content warnings) applied to every new post.

≤ 10 items

defaultTagsarray of string

Extra hidden hashtags (tags) added to every new post.

≤ 8 items

autoFacetsboolean

Detect links, @mentions and #hashtags (default true).

autoLinkCardsboolean

Build a link card from the first link when the post has no media (default true).

Returns object

defaultLangsarray of string | null

Languages written to every new post (langs). null = unset (Bluesky guesses).

1–3 items

defaultThreadgatearray of string | null

Default reply controls. null = everyone can reply; [] = nobody; otherwise any of mentioned, followers, following, list:.

≤ 5 items

defaultPostgateobject | null

Default quote controls. null = quotes allowed.

Show 1 child attributes
disableQuotesboolean
defaultLabelsarray of string

Self-labels (content warnings) applied to every new post.

≤ 10 items

defaultTagsarray of string

Extra hidden hashtags (tags) added to every new post.

≤ 8 items

autoFacetsboolean

Detect links, @mentions and #hashtags (default true).

autoLinkCardsboolean

Build a link card from the first link when the post has no media (default true).

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/bluesky/posting-defaults
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/posting-defaults" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "defaultLangs": [
      "string"
    ],
    "defaultThreadgate": [
      "string"
    ],
    "defaultPostgate": {
      "disableQuotes": true
    },
    "defaultLabels": [
      "porn"
    ],
    "defaultTags": [
      "string"
    ]
  }'
Response · 200

Posts

Bluesky: List Posts

GET/accounts/{accountId}/bluesky/posts

Author feed (app.bsky.feed.getAuthorFeed). The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Cursor pagination: pass next_cursor back as cursor. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: /v1/accounts/{accountId}/focus/posts.

Access: readZernio: GET /v1/accounts/{accountId}/posts

Try it with MCPAsk your agent to call bluesky-posts-list (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 50

1–100

cursorstring
filterstringdefault: "posts_and_author_threads"

posts_with_repliesposts_no_repliesposts_with_mediaposts_and_author_threadsposts_with_video

actorstring

defaults to the account

include_pinsbooleandefault: true

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 35 item attributes
idstringrequired

AT-URI

uristringrequired
cidstringrequired
rkeystring
urlstring (uri)
textstringrequired

≤ 3000 characters

created_atstring (date-time)
indexed_atstring (date-time) | null
langsarray of string
tagsarray of string
labelsarray of string
author_idstring
author_handlestring
author_namestring | null
author_avatarstring (uri) | null
is_ownboolean
is_replyboolean
parent_idstring | null
root_idstring | null
like_countinteger
repost_countinteger
reply_countinteger
quote_countinteger
bookmark_countinteger
embedobject | null
Show 7 child attributes
typestring

imagesvideoexternalrecordrecord_with_media

imagesarray of object
Show 3 item attributes
urlstring (uri)
thumbstring (uri)
altstring
playliststring (uri) | null
thumbnailstring (uri) | null
uristring (uri) | null
titlestring | null
record_uristring | null
viewer_likestring | null
viewer_repoststring | null
viewer_bookmarkedboolean
viewer_thread_mutedboolean
reply_disabledboolean
embedding_disabledboolean
pinnedboolean
reposted_bystring | null
threadgate_rulesarray of string | null
hidden_repliesarray of string
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/bluesky/posts
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/posts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bluesky: Create a Posts item

POST/accounts/{accountId}/bluesky/posts

Publish a post or thread now. The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: /v1/accounts/{accountId}/focus/posts.

Access: writeIdempotency-KeyZernio: POST /v1/posts/{postId}/unpublishPOST /v1/inbox/posts/{postId}/like

Try it with MCPAsk your agent to call bluesky-posts-create (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

textstring

≤ 300 graphemes / 3000 bytes; links, @mentions and #tags become facets

mediaarray of object

≤ 4 items

Show 3 item attributes
mediastring

Socialit media id or public URL

alt_textstring

≤ 2000 characters

captionsarray of object
Show 2 item attributes
mediastring
langstring
threadarray of object

Additional posts of a thread (after the root)

Show 2 item attributes
textstring
mediaarray of object

≤ 4 items

Show 3 item attributes
mediastring

Socialit media id or public URL

alt_textstring

≤ 2000 characters

captionsarray of object
Show 2 item attributes
mediastring
langstring
langsarray of string

≤ 3 items

labelsarray of string
tagsarray of string

≤ 8 items

threadgatearray of string | null

[] = nobody; null = everyone

≤ 5 items

disable_quotesboolean
quotestring

AT-URI / URL of a post, list, feed or starter pack

reply_tostring

AT-URI / URL of the post to reply to

link_cardobject | null
Show 3 child attributes
urlstring (uri)
titlestring
descriptionstring
first_commentstring
video_presentationstring

defaultgif

Returns object

idstringrequired

AT-URI

uristringrequired
cidstringrequired
rkeystring
urlstring (uri)
textstringrequired

≤ 3000 characters

created_atstring (date-time)
indexed_atstring (date-time) | null
langsarray of string
tagsarray of string
labelsarray of string
author_idstring
author_handlestring
author_namestring | null
author_avatarstring (uri) | null
is_ownboolean
is_replyboolean
parent_idstring | null
root_idstring | null
like_countinteger
repost_countinteger
reply_countinteger
quote_countinteger
bookmark_countinteger
embedobject | null
Show 7 child attributes
typestring

imagesvideoexternalrecordrecord_with_media

imagesarray of object
Show 3 item attributes
urlstring (uri)
thumbstring (uri)
altstring
playliststring (uri) | null
thumbnailstring (uri) | null
uristring (uri) | null
titlestring | null
record_uristring | null
viewer_likestring | null
viewer_repoststring | null
viewer_bookmarkedboolean
viewer_thread_mutedboolean
reply_disabledboolean
embedding_disabledboolean
pinnedboolean
reposted_bystring | null
threadgate_rulesarray of string | null
hidden_repliesarray of string

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/posts
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/posts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string",
    "media": [
      {
        "media": "string",
        "alt_text": "string"
      }
    ],
    "thread": [
      {
        "text": "string",
        "media": [
          {
            "media": "string",
            "alt_text": "string"
          }
        ]
      }
    ],
    "langs": [
      "string"
    ],
    "labels": [
      "porn"
    ]
  }'
Response · 201

Bluesky: Get a Posts item

GET/accounts/{accountId}/bluesky/posts/{itemId}

The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: /v1/accounts/{accountId}/focus/posts.

Access: read

Try it with MCPAsk your agent to call bluesky-posts-get (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringrequired

AT-URI

uristringrequired
cidstringrequired
rkeystring
urlstring (uri)
textstringrequired

≤ 3000 characters

created_atstring (date-time)
indexed_atstring (date-time) | null
langsarray of string
tagsarray of string
labelsarray of string
author_idstring
author_handlestring
author_namestring | null
author_avatarstring (uri) | null
is_ownboolean
is_replyboolean
parent_idstring | null
root_idstring | null
like_countinteger
repost_countinteger
reply_countinteger
quote_countinteger
bookmark_countinteger
embedobject | null
Show 7 child attributes
typestring

imagesvideoexternalrecordrecord_with_media

imagesarray of object
Show 3 item attributes
urlstring (uri)
thumbstring (uri)
altstring
playliststring (uri) | null
thumbnailstring (uri) | null
uristring (uri) | null
titlestring | null
record_uristring | null
viewer_likestring | null
viewer_repoststring | null
viewer_bookmarkedboolean
viewer_thread_mutedboolean
reply_disabledboolean
embedding_disabledboolean
pinnedboolean
reposted_bystring | null
threadgate_rulesarray of string | null
hidden_repliesarray of string

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/bluesky/posts/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/posts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bluesky: Delete a Posts item

DELETE/accounts/{accountId}/bluesky/posts/{itemId}

Delete the post with its threadgate/postgate. The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: /v1/accounts/{accountId}/focus/posts.

Access: writeZernio: DELETE /v1/inbox/posts/{postId}/like

Try it with MCPAsk your agent to call bluesky-posts-delete (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/bluesky/posts/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/posts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bluesky: Like (Posts)

POST/accounts/{accountId}/bluesky/posts/{itemId}/like

Like. The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: /v1/accounts/{accountId}/focus/posts.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-posts-like (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/posts/{itemId}/like
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/posts/ITEM_ID/like" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Bluesky: Unlike (Posts)

POST/accounts/{accountId}/bluesky/posts/{itemId}/unlike

Unlike. The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: /v1/accounts/{accountId}/focus/posts.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-posts-unlike (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/posts/{itemId}/unlike
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/posts/ITEM_ID/unlike" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Bluesky: Repost (Posts)

POST/accounts/{accountId}/bluesky/posts/{itemId}/repost

Repost. The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: /v1/accounts/{accountId}/focus/posts.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-posts-repost (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/posts/{itemId}/repost
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/posts/ITEM_ID/repost" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Bluesky: Undo repost (Posts)

POST/accounts/{accountId}/bluesky/posts/{itemId}/unrepost

Undo repost. The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: /v1/accounts/{accountId}/focus/posts.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-posts-unrepost (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/posts/{itemId}/unrepost
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/posts/ITEM_ID/unrepost" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Bluesky: Bookmark (Posts)

POST/accounts/{accountId}/bluesky/posts/{itemId}/bookmark

Bookmark. The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: /v1/accounts/{accountId}/focus/posts.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-posts-bookmark (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/posts/{itemId}/bookmark
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/posts/ITEM_ID/bookmark" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Bluesky: Remove bookmark (Posts)

POST/accounts/{accountId}/bluesky/posts/{itemId}/unbookmark

Remove bookmark. The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: /v1/accounts/{accountId}/focus/posts.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-posts-unbookmark (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/posts/{itemId}/unbookmark
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/posts/ITEM_ID/unbookmark" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Bluesky: Pin to profile (Posts)

POST/accounts/{accountId}/bluesky/posts/{itemId}/pin

Pin to profile. The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: /v1/accounts/{accountId}/focus/posts.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-posts-pin (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/posts/{itemId}/pin
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/posts/ITEM_ID/pin" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Bluesky: Mute thread (Posts)

POST/accounts/{accountId}/bluesky/posts/{itemId}/mute-thread

Mute thread. The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: /v1/accounts/{accountId}/focus/posts.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-posts-mute-thread (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/posts/{itemId}/mute-thread
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/posts/ITEM_ID/mute-thread" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Bluesky: Unmute thread (Posts)

POST/accounts/{accountId}/bluesky/posts/{itemId}/unmute-thread

Unmute thread. The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: /v1/accounts/{accountId}/focus/posts.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-posts-unmute-thread (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/posts/{itemId}/unmute-thread
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/posts/ITEM_ID/unmute-thread" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Bluesky: Reply controls (Posts)

POST/accounts/{accountId}/bluesky/posts/{itemId}/set-reply-controls

Threadgate on a root post: null = everyone, [] = nobody (hidden replies are kept). The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: /v1/accounts/{accountId}/focus/posts.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-posts-set-reply-controls (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

allowarray of string | null

≤ 5 items

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/posts/{itemId}/set-reply-controls
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/posts/ITEM_ID/set-reply-controls" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "allow": [
      "string"
    ]
  }'
Response · 200

Bluesky: Quote controls (Posts)

POST/accounts/{accountId}/bluesky/posts/{itemId}/set-quote-controls

Quote controls. The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: /v1/accounts/{accountId}/focus/posts.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-posts-set-quote-controls (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

disable_quotesbooleanrequired

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/posts/{itemId}/set-quote-controls
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/posts/ITEM_ID/set-quote-controls" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "disable_quotes": true
  }'
Response · 200

Bluesky: Detach quote (Posts)

POST/accounts/{accountId}/bluesky/posts/{itemId}/detach-quote

Remove this post from a specific quote post (postgate detachedEmbeddingUris, ≤ 50). The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: /v1/accounts/{accountId}/focus/posts.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-posts-detach-quote (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

quote_uristringrequired

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/posts/{itemId}/detach-quote
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/posts/ITEM_ID/detach-quote" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "quote_uri": "string"
  }'
Response · 200

Bluesky: Reattach quote (Posts)

POST/accounts/{accountId}/bluesky/posts/{itemId}/reattach-quote

Reattach quote. The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: /v1/accounts/{accountId}/focus/posts.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-posts-reattach-quote (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

quote_uristringrequired

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/posts/{itemId}/reattach-quote
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/posts/ITEM_ID/reattach-quote" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "quote_uri": "string"
  }'
Response · 200

Bluesky: Report (Posts)

POST/accounts/{accountId}/bluesky/posts/{itemId}/report

Report. The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: /v1/accounts/{accountId}/focus/posts.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-posts-report (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

reason_typestring

spamviolationmisleadingsexualrudeother

reasonstring

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/posts/{itemId}/report
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/posts/ITEM_ID/report" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "reason_type": "spam",
    "reason": "string"
  }'
Response · 200

Replies

Bluesky: List Replies

GET/accounts/{accountId}/bluesky/replies

Thread replies under a post: reply, like, hide (threadgate hiddenReplies), delete own, block or report authors. Cursor pagination: pass next_cursor back as cursor. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Generic route: /v1/accounts/{accountId}/focus/replies.

Access: readZernio: GET /v1/inbox/comments/{postId}

Try it with MCPAsk your agent to call bluesky-replies-list (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

poststringrequired

AT-URI or URL of the thread root/post

depthintegerdefault: 6

1–10

limitintegerdefault: 100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 19 item attributes
idstring

AT-URI

textstring
authorstring

handle

author_idstring
author_namestring | null
author_avatarstring (uri) | null
created_atstring (date-time)
like_countinteger
reply_countinteger
repost_countinteger
quote_countinteger
parent_idstring | null
root_idstring | null
depthinteger
likedboolean
like_uristring | null
hiddenboolean
is_ownboolean
urlstring (uri)
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/bluesky/replies
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/replies?post=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bluesky: Create a Replies item

POST/accounts/{accountId}/bluesky/replies

Thread replies under a post: reply, like, hide (threadgate hiddenReplies), delete own, block or report authors. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Generic route: /v1/accounts/{accountId}/focus/replies.

Access: writeIdempotency-KeyZernio: POST /v1/inbox/comments/{postId}POST /v1/inbox/comments/{postId}/{commentId}/hidePOST /v1/inbox/comments/{postId}/{commentId}/like

Try it with MCPAsk your agent to call bluesky-replies-create (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

parentstringrequired

AT-URI of the post/reply to answer

textstringrequired

Returns object

idstring

AT-URI

textstring
authorstring

handle

author_idstring
author_namestring | null
author_avatarstring (uri) | null
created_atstring (date-time)
like_countinteger
reply_countinteger
repost_countinteger
quote_countinteger
parent_idstring | null
root_idstring | null
depthinteger
likedboolean
like_uristring | null
hiddenboolean
is_ownboolean
urlstring (uri)

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/replies
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/replies" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "parent": "string",
    "text": "string"
  }'
Response · 201

Bluesky: Delete a Replies item

DELETE/accounts/{accountId}/bluesky/replies/{itemId}

Delete one of the account’s own replies. Thread replies under a post: reply, like, hide (threadgate hiddenReplies), delete own, block or report authors. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Generic route: /v1/accounts/{accountId}/focus/replies.

Access: writeZernio: DELETE /v1/inbox/comments/{postId}DELETE /v1/inbox/comments/{postId}/{commentId}/hideDELETE /v1/inbox/comments/{postId}/{commentId}/like

Try it with MCPAsk your agent to call bluesky-replies-delete (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/bluesky/replies/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/replies/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bluesky: Hide reply (Replies)

POST/accounts/{accountId}/bluesky/replies/{itemId}/hide

Hide reply. Thread replies under a post: reply, like, hide (threadgate hiddenReplies), delete own, block or report authors. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Generic route: /v1/accounts/{accountId}/focus/replies.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-replies-hide (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/replies/{itemId}/hide
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/replies/ITEM_ID/hide" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Bluesky: Unhide reply (Replies)

POST/accounts/{accountId}/bluesky/replies/{itemId}/unhide

Unhide reply. Thread replies under a post: reply, like, hide (threadgate hiddenReplies), delete own, block or report authors. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Generic route: /v1/accounts/{accountId}/focus/replies.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-replies-unhide (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/replies/{itemId}/unhide
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/replies/ITEM_ID/unhide" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Bluesky: Like (Replies)

POST/accounts/{accountId}/bluesky/replies/{itemId}/like

Like. Thread replies under a post: reply, like, hide (threadgate hiddenReplies), delete own, block or report authors. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Generic route: /v1/accounts/{accountId}/focus/replies.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-replies-like (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/replies/{itemId}/like
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/replies/ITEM_ID/like" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Bluesky: Unlike (Replies)

POST/accounts/{accountId}/bluesky/replies/{itemId}/unlike

Unlike. Thread replies under a post: reply, like, hide (threadgate hiddenReplies), delete own, block or report authors. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Generic route: /v1/accounts/{accountId}/focus/replies.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-replies-unlike (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/replies/{itemId}/unlike
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/replies/ITEM_ID/unlike" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Bluesky: Block author (Replies)

POST/accounts/{accountId}/bluesky/replies/{itemId}/block-author

Block author. Thread replies under a post: reply, like, hide (threadgate hiddenReplies), delete own, block or report authors. Destructive. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Generic route: /v1/accounts/{accountId}/focus/replies.

Access: write

Try it with MCPAsk your agent to call bluesky-replies-block-author (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/replies/{itemId}/block-author
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/replies/ITEM_ID/block-author" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Bluesky: Mute author (Replies)

POST/accounts/{accountId}/bluesky/replies/{itemId}/mute-author

Mute author. Thread replies under a post: reply, like, hide (threadgate hiddenReplies), delete own, block or report authors. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Generic route: /v1/accounts/{accountId}/focus/replies.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-replies-mute-author (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/replies/{itemId}/mute-author
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/replies/ITEM_ID/mute-author" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Bluesky: Report (Replies)

POST/accounts/{accountId}/bluesky/replies/{itemId}/report

Report. Thread replies under a post: reply, like, hide (threadgate hiddenReplies), delete own, block or report authors. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Generic route: /v1/accounts/{accountId}/focus/replies.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-replies-report (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

reason_typestring

spamviolationmisleadingsexualrudeother

reasonstring

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/replies/{itemId}/report
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/replies/ITEM_ID/report" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "reason_type": "spam",
    "reason": "string"
  }'
Response · 200

Drafts

Bluesky: List Bluesky drafts

GET/accounts/{accountId}/bluesky/drafts

Server-side drafts synced with the Bluesky app (app.bsky.draft.*, 2026 lexicon; text-only here). Cursor pagination: pass next_cursor back as cursor. Requires one of: rpc?lxm=app.bsky.draft.createDraft&lxm=app.bsky.draft.deleteDraft&lxm=app.bsky.draft.getDrafts&lxm=app.bsky.draft.updateDraft&aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/drafts.

Access: read

Try it with MCPAsk your agent to call bluesky-drafts-list (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 50

1–100

cursorstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 7 item attributes
idstring
postsarray of object
Show 1 item attributes
textstring

≤ 1000 graphemes

langsarray of string
threadgatearray of string | null
disable_quotesboolean
created_atstring (date-time) | null
updated_atstring (date-time) | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/bluesky/drafts
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/drafts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bluesky: Create a Bluesky drafts item

POST/accounts/{accountId}/bluesky/drafts

Server-side drafts synced with the Bluesky app (app.bsky.draft.*, 2026 lexicon; text-only here). Requires one of: rpc?lxm=app.bsky.draft.createDraft&lxm=app.bsky.draft.deleteDraft&lxm=app.bsky.draft.getDrafts&lxm=app.bsky.draft.updateDraft&aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/drafts.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-drafts-create (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

postsarray of object
Show 1 item attributes
textstring
langsarray of string
threadgatearray of string | null
disable_quotesboolean

Returns object

idstring
postsarray of object
Show 1 item attributes
textstring

≤ 1000 graphemes

langsarray of string
threadgatearray of string | null
disable_quotesboolean
created_atstring (date-time) | null
updated_atstring (date-time) | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/drafts
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/drafts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "posts": [
      {
        "text": "string"
      }
    ],
    "langs": [
      "string"
    ],
    "threadgate": [
      "string"
    ],
    "disable_quotes": true
  }'
Response · 201

Bluesky: Update a Bluesky drafts item

PATCH/accounts/{accountId}/bluesky/drafts/{itemId}

Server-side drafts synced with the Bluesky app (app.bsky.draft.*, 2026 lexicon; text-only here). Requires one of: rpc?lxm=app.bsky.draft.createDraft&lxm=app.bsky.draft.deleteDraft&lxm=app.bsky.draft.getDrafts&lxm=app.bsky.draft.updateDraft&aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/drafts.

Access: write

Try it with MCPAsk your agent to call bluesky-drafts-update (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

postsarray of object
Show 1 item attributes
textstring
langsarray of string
threadgatearray of string | null
disable_quotesboolean

Returns object

idstring
postsarray of object
Show 1 item attributes
textstring

≤ 1000 graphemes

langsarray of string
threadgatearray of string | null
disable_quotesboolean
created_atstring (date-time) | null
updated_atstring (date-time) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/bluesky/drafts/{itemId}
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/drafts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "posts": [
      {
        "text": "string"
      }
    ],
    "langs": [
      "string"
    ],
    "threadgate": [
      "string"
    ],
    "disable_quotes": true
  }'
Response · 200

Bluesky: Delete a Bluesky drafts item

DELETE/accounts/{accountId}/bluesky/drafts/{itemId}

Server-side drafts synced with the Bluesky app (app.bsky.draft.*, 2026 lexicon; text-only here). Requires one of: rpc?lxm=app.bsky.draft.createDraft&lxm=app.bsky.draft.deleteDraft&lxm=app.bsky.draft.getDrafts&lxm=app.bsky.draft.updateDraft&aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/drafts.

Access: write

Try it with MCPAsk your agent to call bluesky-drafts-delete (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/bluesky/drafts/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/drafts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bluesky: Publish draft (Bluesky drafts)

POST/accounts/{accountId}/bluesky/drafts/{itemId}/publish

Publish the draft content (send the draft body as shown) and delete the draft. Server-side drafts synced with the Bluesky app (app.bsky.draft.*, 2026 lexicon; text-only here). Requires one of: rpc?lxm=app.bsky.draft.createDraft&lxm=app.bsky.draft.deleteDraft&lxm=app.bsky.draft.getDrafts&lxm=app.bsky.draft.updateDraft&aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/drafts.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-drafts-publish (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

postsarray of objectrequired
Show 1 item attributes
textstring
langsarray of string
threadgatearray of string | null
disable_quotesboolean
keep_draftboolean

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/drafts/{itemId}/publish
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/drafts/ITEM_ID/publish" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "posts": [
      {
        "text": "string"
      }
    ],
    "langs": [
      "string"
    ],
    "threadgate": [
      "string"
    ],
    "disable_quotes": true,
    "keep_draft": true
  }'
Response · 200

Timeline

Bluesky: List Following timeline

GET/accounts/{accountId}/bluesky/timeline

The account’s home timeline (app.bsky.feed.getTimeline). Cursor pagination: pass next_cursor back as cursor. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Network docs: https://endpoints.bsky.app/ Generic route: /v1/accounts/{accountId}/focus/timeline.

Access: read

Try it with MCPAsk your agent to call bluesky-timeline-list (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 50

1–100

cursorstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 35 item attributes
idstringrequired

AT-URI

uristringrequired
cidstringrequired
rkeystring
urlstring (uri)
textstringrequired

≤ 3000 characters

created_atstring (date-time)
indexed_atstring (date-time) | null
langsarray of string
tagsarray of string
labelsarray of string
author_idstring
author_handlestring
author_namestring | null
author_avatarstring (uri) | null
is_ownboolean
is_replyboolean
parent_idstring | null
root_idstring | null
like_countinteger
repost_countinteger
reply_countinteger
quote_countinteger
bookmark_countinteger
embedobject | null
Show 7 child attributes
typestring

imagesvideoexternalrecordrecord_with_media

imagesarray of object
Show 3 item attributes
urlstring (uri)
thumbstring (uri)
altstring
playliststring (uri) | null
thumbnailstring (uri) | null
uristring (uri) | null
titlestring | null
record_uristring | null
viewer_likestring | null
viewer_repoststring | null
viewer_bookmarkedboolean
viewer_thread_mutedboolean
reply_disabledboolean
embedding_disabledboolean
pinnedboolean
reposted_bystring | null
threadgate_rulesarray of string | null
hidden_repliesarray of string
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/bluesky/timeline
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/timeline" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bluesky: Like (Following timeline)

POST/accounts/{accountId}/bluesky/timeline/{itemId}/like

Like. The account’s home timeline (app.bsky.feed.getTimeline). Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Network docs: https://endpoints.bsky.app/ Generic route: /v1/accounts/{accountId}/focus/timeline.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-timeline-like (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/timeline/{itemId}/like
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/timeline/ITEM_ID/like" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Bluesky: Repost (Following timeline)

POST/accounts/{accountId}/bluesky/timeline/{itemId}/repost

Repost. The account’s home timeline (app.bsky.feed.getTimeline). Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Network docs: https://endpoints.bsky.app/ Generic route: /v1/accounts/{accountId}/focus/timeline.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-timeline-repost (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/timeline/{itemId}/repost
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/timeline/ITEM_ID/repost" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Bluesky: Bookmark (Following timeline)

POST/accounts/{accountId}/bluesky/timeline/{itemId}/bookmark

Bookmark. The account’s home timeline (app.bsky.feed.getTimeline). Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Network docs: https://endpoints.bsky.app/ Generic route: /v1/accounts/{accountId}/focus/timeline.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-timeline-bookmark (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/timeline/{itemId}/bookmark
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/timeline/ITEM_ID/bookmark" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Notifications

Bluesky: List Notifications

GET/accounts/{accountId}/bluesky/notifications

Mentions, replies, quotes, likes, reposts, follows and starter-pack joins. Marking as seen also clears the badge in the Bluesky app. Cursor pagination: pass next_cursor back as cursor. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/notifications.

Access: readZernio: GET /v1/inbox/mentions

Try it with MCPAsk your agent to call bluesky-notifications-list (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 50

1–100

cursorstring
reasonsarray of string
priorityboolean

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 13 item attributes
idstring

AT-URI of the notifying record

typestring

likerepostfollowmentionreplyquotestarterpack-joinedverifiedunverifiedlike-via-repostrepost-via-repostsubscribed-postcontact-match

reason_subjectstring | null

the account’s record that was liked/reposted/quoted

textstring | null
authorstring
author_idstring
author_namestring | null
author_avatarstring (uri) | null
created_atstring (date-time)
is_readboolean
parent_idstring | null
root_idstring | null
urlstring (uri) | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/bluesky/notifications
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/notifications" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bluesky: Mark all as seen (Notifications)

POST/accounts/{accountId}/bluesky/notifications/mark-seen

Mark all as seen. Mentions, replies, quotes, likes, reposts, follows and starter-pack joins. Marking as seen also clears the badge in the Bluesky app. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/notifications.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-notifications-mark-seen (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

seen_atstring (date-time)

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/notifications/mark-seen
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/notifications/mark-seen" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "seen_at": "2026-10-13T09:00:00.000Z"
  }'
Response · 200

Bluesky: Unread count (Notifications)

POST/accounts/{accountId}/bluesky/notifications/unread-count

Unread count. Mentions, replies, quotes, likes, reposts, follows and starter-pack joins. Marking as seen also clears the badge in the Bluesky app. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/notifications.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-notifications-unread-count (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/notifications/unread-count
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/notifications/unread-count" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Bluesky: Reply (Notifications)

POST/accounts/{accountId}/bluesky/notifications/{itemId}/reply

Reply to a mention/reply/quote notification. Mentions, replies, quotes, likes, reposts, follows and starter-pack joins. Marking as seen also clears the badge in the Bluesky app. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/notifications.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-notifications-reply (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

textstringrequired

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/notifications/{itemId}/reply
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/notifications/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string"
  }'
Response · 200

Conversations

Bluesky: List Messages

GET/accounts/{accountId}/bluesky/conversations

Direct messages and message requests (chat.bsky.convo.*). Text only; post links can be embedded. Mute/leave/reactions need the full chat permission set. Cursor pagination: pass next_cursor back as cursor. Requires one of: include:chat.bsky.authFullChatClient?aud=did:web:api.bsky.chat%23bsky_chat | transition:generic + transition:chat.bsky. Generic route: /v1/accounts/{accountId}/focus/conversations.

Access: readZernio: GET /v1/inbox/conversations

Try it with MCPAsk your agent to call bluesky-conversations-list (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 50

1–100

cursorstring
statusstring

requestaccepted

unread_onlyboolean

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 9 item attributes
idstring
titlestring | null
participantsarray of object
Show 5 item attributes
idstring
namestring
usernamestring
avatar_urlstring (uri) | null
is_selfboolean
last_messagestring | null
updated_atstring (date-time) | null
unread_countinteger
statusstring

requestaccepted

mutedboolean
kindstring
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/bluesky/conversations
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/conversations" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bluesky: Create a Messages item

POST/accounts/{accountId}/bluesky/conversations

Start (or reopen) a 1:1 conversation. Direct messages and message requests (chat.bsky.convo.*). Text only; post links can be embedded. Mute/leave/reactions need the full chat permission set. Requires one of: include:chat.bsky.authFullChatClient?aud=did:web:api.bsky.chat%23bsky_chat | transition:generic + transition:chat.bsky. Generic route: /v1/accounts/{accountId}/focus/conversations.

Access: writeIdempotency-KeyZernio: POST /v1/inbox/conversationsPOST /v1/inbox/conversations/{conversationId}/acceptPOST /v1/inbox/conversations/{conversationId}/read

Try it with MCPAsk your agent to call bluesky-conversations-create (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

participantstringrequired

handle or DID

textstring

Returns object

idstring
titlestring | null
participantsarray of object
Show 5 item attributes
idstring
namestring
usernamestring
avatar_urlstring (uri) | null
is_selfboolean
last_messagestring | null
updated_atstring (date-time) | null
unread_countinteger
statusstring

requestaccepted

mutedboolean
kindstring

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/conversations
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/conversations" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "participant": "string",
    "text": "string"
  }'
Response · 201

Bluesky: Get a Messages item

GET/accounts/{accountId}/bluesky/conversations/{itemId}

Direct messages and message requests (chat.bsky.convo.*). Text only; post links can be embedded. Mute/leave/reactions need the full chat permission set. Requires one of: include:chat.bsky.authFullChatClient?aud=did:web:api.bsky.chat%23bsky_chat | transition:generic + transition:chat.bsky. Generic route: /v1/accounts/{accountId}/focus/conversations.

Access: readZernio: GET /v1/inbox/conversations/{conversationId}

Try it with MCPAsk your agent to call bluesky-conversations-get (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstring
titlestring | null
participantsarray of object
Show 5 item attributes
idstring
namestring
usernamestring
avatar_urlstring (uri) | null
is_selfboolean
last_messagestring | null
updated_atstring (date-time) | null
unread_countinteger
statusstring

requestaccepted

mutedboolean
kindstring

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/bluesky/conversations/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/conversations/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bluesky: Delete a Messages item

DELETE/accounts/{accountId}/bluesky/conversations/{itemId}

Leave the conversation. Direct messages and message requests (chat.bsky.convo.*). Text only; post links can be embedded. Mute/leave/reactions need the full chat permission set. Requires one of: include:chat.bsky.authFullChatClient?aud=did:web:api.bsky.chat%23bsky_chat | transition:generic + transition:chat.bsky. Generic route: /v1/accounts/{accountId}/focus/conversations.

Access: write

Try it with MCPAsk your agent to call bluesky-conversations-delete (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/bluesky/conversations/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/conversations/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bluesky: Accept request (Messages)

POST/accounts/{accountId}/bluesky/conversations/{itemId}/accept

Accept request. Direct messages and message requests (chat.bsky.convo.*). Text only; post links can be embedded. Mute/leave/reactions need the full chat permission set. Requires one of: include:chat.bsky.authFullChatClient?aud=did:web:api.bsky.chat%23bsky_chat | transition:generic + transition:chat.bsky. Generic route: /v1/accounts/{accountId}/focus/conversations.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-conversations-accept (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/conversations/{itemId}/accept
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/conversations/ITEM_ID/accept" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Bluesky: Mark read (Messages)

POST/accounts/{accountId}/bluesky/conversations/{itemId}/mark-read

Mark read. Direct messages and message requests (chat.bsky.convo.*). Text only; post links can be embedded. Mute/leave/reactions need the full chat permission set. Requires one of: include:chat.bsky.authFullChatClient?aud=did:web:api.bsky.chat%23bsky_chat | transition:generic + transition:chat.bsky. Generic route: /v1/accounts/{accountId}/focus/conversations.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-conversations-mark-read (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/conversations/{itemId}/mark-read
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/conversations/ITEM_ID/mark-read" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Bluesky: Mute (Messages)

POST/accounts/{accountId}/bluesky/conversations/{itemId}/mute

Mute. Direct messages and message requests (chat.bsky.convo.*). Text only; post links can be embedded. Mute/leave/reactions need the full chat permission set. Requires one of: include:chat.bsky.authFullChatClient?aud=did:web:api.bsky.chat%23bsky_chat | transition:generic + transition:chat.bsky. Generic route: /v1/accounts/{accountId}/focus/conversations.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-conversations-mute (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/conversations/{itemId}/mute
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/conversations/ITEM_ID/mute" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Bluesky: Unmute (Messages)

POST/accounts/{accountId}/bluesky/conversations/{itemId}/unmute

Unmute. Direct messages and message requests (chat.bsky.convo.*). Text only; post links can be embedded. Mute/leave/reactions need the full chat permission set. Requires one of: include:chat.bsky.authFullChatClient?aud=did:web:api.bsky.chat%23bsky_chat | transition:generic + transition:chat.bsky. Generic route: /v1/accounts/{accountId}/focus/conversations.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-conversations-unmute (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/conversations/{itemId}/unmute
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/conversations/ITEM_ID/unmute" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Bluesky: Mark all read (Messages)

POST/accounts/{accountId}/bluesky/conversations/mark-all-read

Mark all read. Direct messages and message requests (chat.bsky.convo.*). Text only; post links can be embedded. Mute/leave/reactions need the full chat permission set. Requires one of: include:chat.bsky.authFullChatClient?aud=did:web:api.bsky.chat%23bsky_chat | transition:generic + transition:chat.bsky. Generic route: /v1/accounts/{accountId}/focus/conversations.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-conversations-mark-all-read (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

statusstring

requestaccepted

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/conversations/mark-all-read
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/conversations/mark-all-read" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "request"
  }'
Response · 200

Messages

Bluesky: List Conversation

GET/accounts/{accountId}/bluesky/messages

Messages of one conversation with reactions; delete is “for me” only. Cursor pagination: pass next_cursor back as cursor. Requires one of: include:chat.bsky.authFullChatClient?aud=did:web:api.bsky.chat%23bsky_chat | transition:generic + transition:chat.bsky. Generic route: /v1/accounts/{accountId}/focus/messages.

Access: readZernio: GET /v1/inbox/conversations/{conversationId}/messages

Try it with MCPAsk your agent to call bluesky-messages-list (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 50

1–100

cursorstring
conversationstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 10 item attributes
idstring

<conversation_id>:<message_id>

message_idstring
conversation_idstring
textstring | null

≤ 10000 characters

directionstring

inout

from_idstring
sent_atstring (date-time)
deletedboolean
reactionsarray of object
Show 2 item attributes
valuestring
from_idstring
embed_uristring | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/bluesky/messages
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/messages" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bluesky: Create a Conversation item

POST/accounts/{accountId}/bluesky/messages

Messages of one conversation with reactions; delete is “for me” only. Requires one of: include:chat.bsky.authFullChatClient?aud=did:web:api.bsky.chat%23bsky_chat | transition:generic + transition:chat.bsky. Generic route: /v1/accounts/{accountId}/focus/messages.

Access: writeIdempotency-KeyZernio: POST /v1/inbox/conversations/{conversationId}/messagesPOST /v1/inbox/conversations/{conversationId}/messages/{messageId}/reactions

Try it with MCPAsk your agent to call bluesky-messages-create (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

conversationstringrequired

conversation id, or a handle/DID to DM

textstringrequired

≤ 1000 graphemes

embed_uristring

post to embed

Returns object

idstring

<conversation_id>:<message_id>

message_idstring
conversation_idstring
textstring | null

≤ 10000 characters

directionstring

inout

from_idstring
sent_atstring (date-time)
deletedboolean
reactionsarray of object
Show 2 item attributes
valuestring
from_idstring
embed_uristring | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/messages
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/messages" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "conversation": "string",
    "text": "string",
    "embed_uri": "string"
  }'
Response · 201

Bluesky: Delete a Conversation item

DELETE/accounts/{accountId}/bluesky/messages/{itemId}

Delete for the account only. Messages of one conversation with reactions; delete is “for me” only. Requires one of: include:chat.bsky.authFullChatClient?aud=did:web:api.bsky.chat%23bsky_chat | transition:generic + transition:chat.bsky. Generic route: /v1/accounts/{accountId}/focus/messages.

Access: writeZernio: DELETE /v1/inbox/conversations/{conversationId}/messages/{messageId}DELETE /v1/inbox/conversations/{conversationId}/messages/{messageId}/reactions

Try it with MCPAsk your agent to call bluesky-messages-delete (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/bluesky/messages/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/messages/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bluesky: React (Conversation)

POST/accounts/{accountId}/bluesky/messages/{itemId}/react

React. Messages of one conversation with reactions; delete is “for me” only. Requires one of: include:chat.bsky.authFullChatClient?aud=did:web:api.bsky.chat%23bsky_chat | transition:generic + transition:chat.bsky. Generic route: /v1/accounts/{accountId}/focus/messages.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-messages-react (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

valuestringrequired

one emoji

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/messages/{itemId}/react
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/messages/ITEM_ID/react" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "value": "string"
  }'
Response · 200

Bluesky: Remove reaction (Conversation)

POST/accounts/{accountId}/bluesky/messages/{itemId}/unreact

Remove reaction. Messages of one conversation with reactions; delete is “for me” only. Requires one of: include:chat.bsky.authFullChatClient?aud=did:web:api.bsky.chat%23bsky_chat | transition:generic + transition:chat.bsky. Generic route: /v1/accounts/{accountId}/focus/messages.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-messages-unreact (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

valuestringrequired

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/messages/{itemId}/unreact
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/messages/ITEM_ID/unreact" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "value": "string"
  }'
Response · 200

Notification preferences

Bluesky: Get Notification settings

GET/accounts/{accountId}/bluesky/notification-preferences

Which notifications the account receives (app.bsky.notification.getPreferences / putPreferencesV2). Requires one of: include:app.bsky.authManageNotifications?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/notification-preferences.

Access: read

Try it with MCPAsk your agent to call bluesky-notification-preferences-get (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

chatobject
Show 3 child attributes
includestring

allfollowsaccepted

listboolean
pushboolean
followobject
Show 3 child attributes
includestring

allfollowsaccepted

listboolean
pushboolean
likeobject
Show 3 child attributes
includestring

allfollowsaccepted

listboolean
pushboolean
likeViaRepostobject
Show 3 child attributes
includestring

allfollowsaccepted

listboolean
pushboolean
mentionobject
Show 3 child attributes
includestring

allfollowsaccepted

listboolean
pushboolean
quoteobject
Show 3 child attributes
includestring

allfollowsaccepted

listboolean
pushboolean
replyobject
Show 3 child attributes
includestring

allfollowsaccepted

listboolean
pushboolean
repostobject
Show 3 child attributes
includestring

allfollowsaccepted

listboolean
pushboolean
repostViaRepostobject
Show 3 child attributes
includestring

allfollowsaccepted

listboolean
pushboolean
starterpackJoinedobject
Show 3 child attributes
includestring

allfollowsaccepted

listboolean
pushboolean
subscribedPostobject
Show 3 child attributes
includestring

allfollowsaccepted

listboolean
pushboolean
unverifiedobject
Show 3 child attributes
includestring

allfollowsaccepted

listboolean
pushboolean
verifiedobject
Show 3 child attributes
includestring

allfollowsaccepted

listboolean
pushboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/bluesky/notification-preferences
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/notification-preferences" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bluesky: Update Notification settings

PATCH/accounts/{accountId}/bluesky/notification-preferences

Which notifications the account receives (app.bsky.notification.getPreferences / putPreferencesV2). Requires one of: include:app.bsky.authManageNotifications?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/notification-preferences.

Access: write

Try it with MCPAsk your agent to call bluesky-notification-preferences-update (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

chatobject
Show 3 child attributes
includestring

allfollowsaccepted

listboolean
pushboolean
followobject
Show 3 child attributes
includestring

allfollowsaccepted

listboolean
pushboolean
likeobject
Show 3 child attributes
includestring

allfollowsaccepted

listboolean
pushboolean
likeViaRepostobject
Show 3 child attributes
includestring

allfollowsaccepted

listboolean
pushboolean
mentionobject
Show 3 child attributes
includestring

allfollowsaccepted

listboolean
pushboolean
quoteobject
Show 3 child attributes
includestring

allfollowsaccepted

listboolean
pushboolean
replyobject
Show 3 child attributes
includestring

allfollowsaccepted

listboolean
pushboolean
repostobject
Show 3 child attributes
includestring

allfollowsaccepted

listboolean
pushboolean
repostViaRepostobject
Show 3 child attributes
includestring

allfollowsaccepted

listboolean
pushboolean
starterpackJoinedobject
Show 3 child attributes
includestring

allfollowsaccepted

listboolean
pushboolean
subscribedPostobject
Show 3 child attributes
includestring

allfollowsaccepted

listboolean
pushboolean
unverifiedobject
Show 3 child attributes
includestring

allfollowsaccepted

listboolean
pushboolean
verifiedobject
Show 3 child attributes
includestring

allfollowsaccepted

listboolean
pushboolean

Returns object

chatobject
Show 3 child attributes
includestring

allfollowsaccepted

listboolean
pushboolean
followobject
Show 3 child attributes
includestring

allfollowsaccepted

listboolean
pushboolean
likeobject
Show 3 child attributes
includestring

allfollowsaccepted

listboolean
pushboolean
likeViaRepostobject
Show 3 child attributes
includestring

allfollowsaccepted

listboolean
pushboolean
mentionobject
Show 3 child attributes
includestring

allfollowsaccepted

listboolean
pushboolean
quoteobject
Show 3 child attributes
includestring

allfollowsaccepted

listboolean
pushboolean
replyobject
Show 3 child attributes
includestring

allfollowsaccepted

listboolean
pushboolean
repostobject
Show 3 child attributes
includestring

allfollowsaccepted

listboolean
pushboolean
repostViaRepostobject
Show 3 child attributes
includestring

allfollowsaccepted

listboolean
pushboolean
starterpackJoinedobject
Show 3 child attributes
includestring

allfollowsaccepted

listboolean
pushboolean
subscribedPostobject
Show 3 child attributes
includestring

allfollowsaccepted

listboolean
pushboolean
unverifiedobject
Show 3 child attributes
includestring

allfollowsaccepted

listboolean
pushboolean
verifiedobject
Show 3 child attributes
includestring

allfollowsaccepted

listboolean
pushboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/bluesky/notification-preferences
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/notification-preferences" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "chat": {
      "include": "all",
      "list": true
    },
    "follow": {
      "include": "all",
      "list": true
    },
    "like": {
      "include": "all",
      "list": true
    },
    "likeViaRepost": {
      "include": "all",
      "list": true
    },
    "mention": {
      "include": "all",
      "list": true
    }
  }'
Response · 200

Activity subscriptions

Bluesky: List Post alerts

GET/accounts/{accountId}/bluesky/activity-subscriptions

“Notify me when X posts” subscriptions (app.bsky.notification.*ActivitySubscription). Cursor pagination: pass next_cursor back as cursor. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/activity-subscriptions.

Access: read

Try it with MCPAsk your agent to call bluesky-activity-subscriptions-list (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 50

1–100

cursorstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 24 item attributes
idstring

DID

didstring
handlestring
display_namestring | null
descriptionstring | null
avatar_urlstring (uri) | null
banner_urlstring (uri) | null
followers_countinteger | null
following_countinteger | null
posts_countinteger | null
labelsarray of string
is_botboolean
verifiedboolean
created_atstring (date-time) | null
indexed_atstring (date-time) | null
viewer_followingstring | null

follow record URI when the account follows them

viewer_followed_bystring | null
viewer_mutedboolean
viewer_blockingstring | null

block record URI

viewer_blocked_byboolean
allow_incoming_chatstring | null

allfollowingnone

urlstring (uri)
notify_postsboolean
notify_repliesboolean
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/bluesky/activity-subscriptions
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/activity-subscriptions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bluesky: Create a Post alerts item

POST/accounts/{accountId}/bluesky/activity-subscriptions

“Notify me when X posts” subscriptions (app.bsky.notification.*ActivitySubscription). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/activity-subscriptions.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-activity-subscriptions-create (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

actorstringrequired
notify_postsbooleandefault: true
notify_repliesbooleandefault: false

Returns object

idstring

DID

didstring
handlestring
display_namestring | null
descriptionstring | null
avatar_urlstring (uri) | null
banner_urlstring (uri) | null
followers_countinteger | null
following_countinteger | null
posts_countinteger | null
labelsarray of string
is_botboolean
verifiedboolean
created_atstring (date-time) | null
indexed_atstring (date-time) | null
viewer_followingstring | null

follow record URI when the account follows them

viewer_followed_bystring | null
viewer_mutedboolean
viewer_blockingstring | null

block record URI

viewer_blocked_byboolean
allow_incoming_chatstring | null

allfollowingnone

urlstring (uri)
notify_postsboolean
notify_repliesboolean

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/activity-subscriptions
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/activity-subscriptions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "actor": "string",
    "notify_posts": true,
    "notify_replies": false
  }'
Response · 201

Bluesky: Update a Post alerts item

PATCH/accounts/{accountId}/bluesky/activity-subscriptions/{itemId}

“Notify me when X posts” subscriptions (app.bsky.notification.*ActivitySubscription). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/activity-subscriptions.

Access: write

Try it with MCPAsk your agent to call bluesky-activity-subscriptions-update (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

notify_postsboolean
notify_repliesboolean

Returns object

idstring

DID

didstring
handlestring
display_namestring | null
descriptionstring | null
avatar_urlstring (uri) | null
banner_urlstring (uri) | null
followers_countinteger | null
following_countinteger | null
posts_countinteger | null
labelsarray of string
is_botboolean
verifiedboolean
created_atstring (date-time) | null
indexed_atstring (date-time) | null
viewer_followingstring | null

follow record URI when the account follows them

viewer_followed_bystring | null
viewer_mutedboolean
viewer_blockingstring | null

block record URI

viewer_blocked_byboolean
allow_incoming_chatstring | null

allfollowingnone

urlstring (uri)
notify_postsboolean
notify_repliesboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/bluesky/activity-subscriptions/{itemId}
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/activity-subscriptions/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "notify_posts": true,
    "notify_replies": true
  }'
Response · 200

Bluesky: Delete a Post alerts item

DELETE/accounts/{accountId}/bluesky/activity-subscriptions/{itemId}

“Notify me when X posts” subscriptions (app.bsky.notification.*ActivitySubscription). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/activity-subscriptions.

Access: write

Try it with MCPAsk your agent to call bluesky-activity-subscriptions-delete (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/bluesky/activity-subscriptions/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/activity-subscriptions/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Chat settings

Bluesky: Get Who can message

GET/accounts/{accountId}/bluesky/chat-settings

chat.bsky.actor.declaration: brands usually allow messages from everyone. Requires one of: include:chat.bsky.authFullChatClient?aud=did:web:api.bsky.chat%23bsky_chat | transition:generic + transition:chat.bsky. Generic route: /v1/accounts/{accountId}/focus/chat-settings.

Access: read

Try it with MCPAsk your agent to call bluesky-chat-settings-get (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

allow_incomingstring

allfollowingnone

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/bluesky/chat-settings
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/chat-settings" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bluesky: Update Who can message

PATCH/accounts/{accountId}/bluesky/chat-settings

chat.bsky.actor.declaration: brands usually allow messages from everyone. Requires one of: include:chat.bsky.authFullChatClient?aud=did:web:api.bsky.chat%23bsky_chat | transition:generic + transition:chat.bsky. Generic route: /v1/accounts/{accountId}/focus/chat-settings.

Access: write

Try it with MCPAsk your agent to call bluesky-chat-settings-update (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

allow_incomingstringrequired

allfollowingnone

Returns object

allow_incomingstring

allfollowingnone

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/bluesky/chat-settings
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/chat-settings" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "allow_incoming": "all"
  }'
Response · 200

Likes

Bluesky: List Likes

GET/accounts/{accountId}/bluesky/likes

Posts the account liked (app.bsky.feed.getActorLikes, own account only). Cursor pagination: pass next_cursor back as cursor. Requires one of: repo:app.bsky.feed.like | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/likes.

Access: read

Try it with MCPAsk your agent to call bluesky-likes-list (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 50

1–100

cursorstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 35 item attributes
idstringrequired

AT-URI

uristringrequired
cidstringrequired
rkeystring
urlstring (uri)
textstringrequired

≤ 3000 characters

created_atstring (date-time)
indexed_atstring (date-time) | null
langsarray of string
tagsarray of string
labelsarray of string
author_idstring
author_handlestring
author_namestring | null
author_avatarstring (uri) | null
is_ownboolean
is_replyboolean
parent_idstring | null
root_idstring | null
like_countinteger
repost_countinteger
reply_countinteger
quote_countinteger
bookmark_countinteger
embedobject | null
Show 7 child attributes
typestring

imagesvideoexternalrecordrecord_with_media

imagesarray of object
Show 3 item attributes
urlstring (uri)
thumbstring (uri)
altstring
playliststring (uri) | null
thumbnailstring (uri) | null
uristring (uri) | null
titlestring | null
record_uristring | null
viewer_likestring | null
viewer_repoststring | null
viewer_bookmarkedboolean
viewer_thread_mutedboolean
reply_disabledboolean
embedding_disabledboolean
pinnedboolean
reposted_bystring | null
threadgate_rulesarray of string | null
hidden_repliesarray of string
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/bluesky/likes
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/likes" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bluesky: Create a Likes item

POST/accounts/{accountId}/bluesky/likes

Posts the account liked (app.bsky.feed.getActorLikes, own account only). Requires one of: repo:app.bsky.feed.like | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/likes.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-likes-create (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

uristringrequired

post AT-URI or bsky.app URL

Returns object

idstringrequired

AT-URI

uristringrequired
cidstringrequired
rkeystring
urlstring (uri)
textstringrequired

≤ 3000 characters

created_atstring (date-time)
indexed_atstring (date-time) | null
langsarray of string
tagsarray of string
labelsarray of string
author_idstring
author_handlestring
author_namestring | null
author_avatarstring (uri) | null
is_ownboolean
is_replyboolean
parent_idstring | null
root_idstring | null
like_countinteger
repost_countinteger
reply_countinteger
quote_countinteger
bookmark_countinteger
embedobject | null
Show 7 child attributes
typestring

imagesvideoexternalrecordrecord_with_media

imagesarray of object
Show 3 item attributes
urlstring (uri)
thumbstring (uri)
altstring
playliststring (uri) | null
thumbnailstring (uri) | null
uristring (uri) | null
titlestring | null
record_uristring | null
viewer_likestring | null
viewer_repoststring | null
viewer_bookmarkedboolean
viewer_thread_mutedboolean
reply_disabledboolean
embedding_disabledboolean
pinnedboolean
reposted_bystring | null
threadgate_rulesarray of string | null
hidden_repliesarray of string

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/likes
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/likes" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "uri": "string"
  }'
Response · 201

Bluesky: Delete a Likes item

DELETE/accounts/{accountId}/bluesky/likes/{itemId}

Unlike (id = post or like URI). Posts the account liked (app.bsky.feed.getActorLikes, own account only). Requires one of: repo:app.bsky.feed.like | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/likes.

Access: write

Try it with MCPAsk your agent to call bluesky-likes-delete (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/bluesky/likes/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/likes/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Reposts

Bluesky: List Reposts

GET/accounts/{accountId}/bluesky/reposts

The account’s reposts (app.bsky.feed.repost records). Cursor pagination: pass next_cursor back as cursor. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/reposts.

Access: read

Try it with MCPAsk your agent to call bluesky-reposts-list (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 50

1–100

cursorstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 37 item attributes
idstring

AT-URI

uristring
cidstring
rkeystring
urlstring (uri)
textstring

≤ 3000 characters

created_atstring (date-time)
indexed_atstring (date-time) | null
langsarray of string
tagsarray of string
labelsarray of string
author_idstring
author_handlestring
author_namestring | null
author_avatarstring (uri) | null
is_ownboolean
is_replyboolean
parent_idstring | null
root_idstring | null
like_countinteger
repost_countinteger
reply_countinteger
quote_countinteger
bookmark_countinteger
embedobject | null
Show 7 child attributes
typestring

imagesvideoexternalrecordrecord_with_media

imagesarray of object
Show 3 item attributes
urlstring (uri)
thumbstring (uri)
altstring
playliststring (uri) | null
thumbnailstring (uri) | null
uristring (uri) | null
titlestring | null
record_uristring | null
viewer_likestring | null
viewer_repoststring | null
viewer_bookmarkedboolean
viewer_thread_mutedboolean
reply_disabledboolean
embedding_disabledboolean
pinnedboolean
reposted_bystring | null
threadgate_rulesarray of string | null
hidden_repliesarray of string
repost_uristring
reposted_atstring (date-time)
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/bluesky/reposts
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/reposts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bluesky: Create a Reposts item

POST/accounts/{accountId}/bluesky/reposts

The account’s reposts (app.bsky.feed.repost records). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/reposts.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-reposts-create (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

uristringrequired

post AT-URI or bsky.app URL

Returns object

idstring

AT-URI

uristring
cidstring
rkeystring
urlstring (uri)
textstring

≤ 3000 characters

created_atstring (date-time)
indexed_atstring (date-time) | null
langsarray of string
tagsarray of string
labelsarray of string
author_idstring
author_handlestring
author_namestring | null
author_avatarstring (uri) | null
is_ownboolean
is_replyboolean
parent_idstring | null
root_idstring | null
like_countinteger
repost_countinteger
reply_countinteger
quote_countinteger
bookmark_countinteger
embedobject | null
Show 7 child attributes
typestring

imagesvideoexternalrecordrecord_with_media

imagesarray of object
Show 3 item attributes
urlstring (uri)
thumbstring (uri)
altstring
playliststring (uri) | null
thumbnailstring (uri) | null
uristring (uri) | null
titlestring | null
record_uristring | null
viewer_likestring | null
viewer_repoststring | null
viewer_bookmarkedboolean
viewer_thread_mutedboolean
reply_disabledboolean
embedding_disabledboolean
pinnedboolean
reposted_bystring | null
threadgate_rulesarray of string | null
hidden_repliesarray of string
repost_uristring
reposted_atstring (date-time)

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/reposts
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/reposts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "uri": "string"
  }'
Response · 201

Bluesky: Delete a Reposts item

DELETE/accounts/{accountId}/bluesky/reposts/{itemId}

Undo (id = repost or post URI). The account’s reposts (app.bsky.feed.repost records). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/reposts.

Access: write

Try it with MCPAsk your agent to call bluesky-reposts-delete (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/bluesky/reposts/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/reposts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bookmarks

Bluesky: List Bookmarks

GET/accounts/{accountId}/bluesky/bookmarks

Private bookmarks (app.bsky.bookmark.*). Cursor pagination: pass next_cursor back as cursor. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/bookmarks.

Access: read

Try it with MCPAsk your agent to call bluesky-bookmarks-list (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 50

1–100

cursorstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 36 item attributes
idstring

AT-URI

uristring
cidstring
rkeystring
urlstring (uri)
textstring

≤ 3000 characters

created_atstring (date-time)
indexed_atstring (date-time) | null
langsarray of string
tagsarray of string
labelsarray of string
author_idstring
author_handlestring
author_namestring | null
author_avatarstring (uri) | null
is_ownboolean
is_replyboolean
parent_idstring | null
root_idstring | null
like_countinteger
repost_countinteger
reply_countinteger
quote_countinteger
bookmark_countinteger
embedobject | null
Show 7 child attributes
typestring

imagesvideoexternalrecordrecord_with_media

imagesarray of object
Show 3 item attributes
urlstring (uri)
thumbstring (uri)
altstring
playliststring (uri) | null
thumbnailstring (uri) | null
uristring (uri) | null
titlestring | null
record_uristring | null
viewer_likestring | null
viewer_repoststring | null
viewer_bookmarkedboolean
viewer_thread_mutedboolean
reply_disabledboolean
embedding_disabledboolean
pinnedboolean
reposted_bystring | null
threadgate_rulesarray of string | null
hidden_repliesarray of string
bookmarked_atstring (date-time) | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/bluesky/bookmarks
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/bookmarks" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bluesky: Create a Bookmarks item

POST/accounts/{accountId}/bluesky/bookmarks

Private bookmarks (app.bsky.bookmark.*). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/bookmarks.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-bookmarks-create (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

uristringrequired

post AT-URI or bsky.app URL

Returns object

idstring

AT-URI

uristring
cidstring
rkeystring
urlstring (uri)
textstring

≤ 3000 characters

created_atstring (date-time)
indexed_atstring (date-time) | null
langsarray of string
tagsarray of string
labelsarray of string
author_idstring
author_handlestring
author_namestring | null
author_avatarstring (uri) | null
is_ownboolean
is_replyboolean
parent_idstring | null
root_idstring | null
like_countinteger
repost_countinteger
reply_countinteger
quote_countinteger
bookmark_countinteger
embedobject | null
Show 7 child attributes
typestring

imagesvideoexternalrecordrecord_with_media

imagesarray of object
Show 3 item attributes
urlstring (uri)
thumbstring (uri)
altstring
playliststring (uri) | null
thumbnailstring (uri) | null
uristring (uri) | null
titlestring | null
record_uristring | null
viewer_likestring | null
viewer_repoststring | null
viewer_bookmarkedboolean
viewer_thread_mutedboolean
reply_disabledboolean
embedding_disabledboolean
pinnedboolean
reposted_bystring | null
threadgate_rulesarray of string | null
hidden_repliesarray of string
bookmarked_atstring (date-time) | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/bookmarks
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/bookmarks" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "uri": "string"
  }'
Response · 201

Bluesky: Delete a Bookmarks item

DELETE/accounts/{accountId}/bluesky/bookmarks/{itemId}

Private bookmarks (app.bsky.bookmark.*). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/bookmarks.

Access: write

Try it with MCPAsk your agent to call bluesky-bookmarks-delete (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/bluesky/bookmarks/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/bookmarks/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Post engagement

Bluesky: List Who engaged

GET/accounts/{accountId}/bluesky/post-engagement

Accounts that liked, reposted or quoted a post (getLikes / getRepostedBy / getQuotes). Cursor pagination: pass next_cursor back as cursor. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/post-engagement.

Access: read

Try it with MCPAsk your agent to call bluesky-post-engagement-list (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

uristringrequired
typestringdefault: "likes"

likesrepostsquotes

limitintegerdefault: 50
cursorstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 25 item attributes
idstring

DID

didstring
handlestring
display_namestring | null
descriptionstring | null
avatar_urlstring (uri) | null
banner_urlstring (uri) | null
followers_countinteger | null
following_countinteger | null
posts_countinteger | null
labelsarray of string
is_botboolean
verifiedboolean
created_atstring (date-time) | null
indexed_atstring (date-time) | null
viewer_followingstring | null

follow record URI when the account follows them

viewer_followed_bystring | null
viewer_mutedboolean
viewer_blockingstring | null

block record URI

viewer_blocked_byboolean
allow_incoming_chatstring | null

allfollowingnone

urlstring (uri)
engaged_atstring (date-time) | null
quote_uristring | null
quote_textstring | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/bluesky/post-engagement
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/post-engagement?uri=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Followers

Bluesky: List Followers

GET/accounts/{accountId}/bluesky/followers

Cursor pagination: pass next_cursor back as cursor. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/followers.

Access: read

Try it with MCPAsk your agent to call bluesky-followers-list (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 50

1–100

cursorstring
actorstring

defaults to the account

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 22 item attributes
idstringrequired

DID

didstring
handlestringrequired
display_namestring | null
descriptionstring | null
avatar_urlstring (uri) | null
banner_urlstring (uri) | null
followers_countinteger | null
following_countinteger | null
posts_countinteger | null
labelsarray of string
is_botboolean
verifiedboolean
created_atstring (date-time) | null
indexed_atstring (date-time) | null
viewer_followingstring | null

follow record URI when the account follows them

viewer_followed_bystring | null
viewer_mutedboolean
viewer_blockingstring | null

block record URI

viewer_blocked_byboolean
allow_incoming_chatstring | null

allfollowingnone

urlstring (uri)
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/bluesky/followers
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/followers" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bluesky: Follow (Followers)

POST/accounts/{accountId}/bluesky/followers/{itemId}/follow

Follow. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/followers.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-followers-follow (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/followers/{itemId}/follow
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/followers/ITEM_ID/follow" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Bluesky: Unfollow (Followers)

POST/accounts/{accountId}/bluesky/followers/{itemId}/unfollow

Unfollow. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/followers.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-followers-unfollow (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/followers/{itemId}/unfollow
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/followers/ITEM_ID/unfollow" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Bluesky: Mute (Followers)

POST/accounts/{accountId}/bluesky/followers/{itemId}/mute

Mute. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/followers.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-followers-mute (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/followers/{itemId}/mute
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/followers/ITEM_ID/mute" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Bluesky: Unmute (Followers)

POST/accounts/{accountId}/bluesky/followers/{itemId}/unmute

Unmute. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/followers.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-followers-unmute (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/followers/{itemId}/unmute
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/followers/ITEM_ID/unmute" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Bluesky: Block (Followers)

POST/accounts/{accountId}/bluesky/followers/{itemId}/block

Block. Destructive. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/followers.

Access: write

Try it with MCPAsk your agent to call bluesky-followers-block (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/followers/{itemId}/block
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/followers/ITEM_ID/block" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Bluesky: Unblock (Followers)

POST/accounts/{accountId}/bluesky/followers/{itemId}/unblock

Unblock. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/followers.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-followers-unblock (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/followers/{itemId}/unblock
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/followers/ITEM_ID/unblock" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Bluesky: Report account (Followers)

POST/accounts/{accountId}/bluesky/followers/{itemId}/report

Report account. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/followers.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-followers-report (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

reason_typestring

spamviolationmisleadingsexualrudeother

reasonstring

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/followers/{itemId}/report
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/followers/ITEM_ID/report" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "reason_type": "spam",
    "reason": "string"
  }'
Response · 200

Following

Bluesky: List Following

GET/accounts/{accountId}/bluesky/following

Cursor pagination: pass next_cursor back as cursor. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/following.

Access: read

Try it with MCPAsk your agent to call bluesky-following-list (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 50

1–100

cursorstring
actorstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 22 item attributes
idstringrequired

DID

didstring
handlestringrequired
display_namestring | null
descriptionstring | null
avatar_urlstring (uri) | null
banner_urlstring (uri) | null
followers_countinteger | null
following_countinteger | null
posts_countinteger | null
labelsarray of string
is_botboolean
verifiedboolean
created_atstring (date-time) | null
indexed_atstring (date-time) | null
viewer_followingstring | null

follow record URI when the account follows them

viewer_followed_bystring | null
viewer_mutedboolean
viewer_blockingstring | null

block record URI

viewer_blocked_byboolean
allow_incoming_chatstring | null

allfollowingnone

urlstring (uri)
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/bluesky/following
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/following" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bluesky: Create a Following item

POST/accounts/{accountId}/bluesky/following

Follow an account. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/following.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-following-create (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

actorstringrequired

handle or DID

Returns object

idstringrequired

DID

didstring
handlestringrequired
display_namestring | null
descriptionstring | null
avatar_urlstring (uri) | null
banner_urlstring (uri) | null
followers_countinteger | null
following_countinteger | null
posts_countinteger | null
labelsarray of string
is_botboolean
verifiedboolean
created_atstring (date-time) | null
indexed_atstring (date-time) | null
viewer_followingstring | null

follow record URI when the account follows them

viewer_followed_bystring | null
viewer_mutedboolean
viewer_blockingstring | null

block record URI

viewer_blocked_byboolean
allow_incoming_chatstring | null

allfollowingnone

urlstring (uri)

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/following
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/following" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "actor": "string"
  }'
Response · 201

Bluesky: Delete a Following item

DELETE/accounts/{accountId}/bluesky/following/{itemId}

Unfollow. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/following.

Access: write

Try it with MCPAsk your agent to call bluesky-following-delete (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/bluesky/following/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/following/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bluesky: Mute (Following)

POST/accounts/{accountId}/bluesky/following/{itemId}/mute

Mute. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/following.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-following-mute (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/following/{itemId}/mute
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/following/ITEM_ID/mute" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Bluesky: Block (Following)

POST/accounts/{accountId}/bluesky/following/{itemId}/block

Block. Destructive. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/following.

Access: write

Try it with MCPAsk your agent to call bluesky-following-block (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/following/{itemId}/block
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/following/ITEM_ID/block" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Blocks

Bluesky: List Blocked accounts

GET/accounts/{accountId}/bluesky/blocks

Blocks are public records (app.bsky.graph.block). Cursor pagination: pass next_cursor back as cursor. Requires one of: repo:app.bsky.graph.block | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/blocks.

Access: read

Try it with MCPAsk your agent to call bluesky-blocks-list (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 50

1–100

cursorstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 22 item attributes
idstringrequired

DID

didstring
handlestringrequired
display_namestring | null
descriptionstring | null
avatar_urlstring (uri) | null
banner_urlstring (uri) | null
followers_countinteger | null
following_countinteger | null
posts_countinteger | null
labelsarray of string
is_botboolean
verifiedboolean
created_atstring (date-time) | null
indexed_atstring (date-time) | null
viewer_followingstring | null

follow record URI when the account follows them

viewer_followed_bystring | null
viewer_mutedboolean
viewer_blockingstring | null

block record URI

viewer_blocked_byboolean
allow_incoming_chatstring | null

allfollowingnone

urlstring (uri)
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/bluesky/blocks
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/blocks" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bluesky: Create a Blocked accounts item

POST/accounts/{accountId}/bluesky/blocks

Blocks are public records (app.bsky.graph.block). Requires one of: repo:app.bsky.graph.block | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/blocks.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-blocks-create (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

actorstringrequired

handle or DID

Returns object

idstringrequired

DID

didstring
handlestringrequired
display_namestring | null
descriptionstring | null
avatar_urlstring (uri) | null
banner_urlstring (uri) | null
followers_countinteger | null
following_countinteger | null
posts_countinteger | null
labelsarray of string
is_botboolean
verifiedboolean
created_atstring (date-time) | null
indexed_atstring (date-time) | null
viewer_followingstring | null

follow record URI when the account follows them

viewer_followed_bystring | null
viewer_mutedboolean
viewer_blockingstring | null

block record URI

viewer_blocked_byboolean
allow_incoming_chatstring | null

allfollowingnone

urlstring (uri)

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/blocks
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/blocks" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "actor": "string"
  }'
Response · 201

Bluesky: Delete a Blocked accounts item

DELETE/accounts/{accountId}/bluesky/blocks/{itemId}

Blocks are public records (app.bsky.graph.block). Requires one of: repo:app.bsky.graph.block | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/blocks.

Access: write

Try it with MCPAsk your agent to call bluesky-blocks-delete (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/bluesky/blocks/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/blocks/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mutes

Bluesky: List Muted accounts

GET/accounts/{accountId}/bluesky/mutes

Mutes are private (app.bsky.graph.muteActor). Cursor pagination: pass next_cursor back as cursor. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/mutes.

Access: read

Try it with MCPAsk your agent to call bluesky-mutes-list (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 50

1–100

cursorstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 22 item attributes
idstringrequired

DID

didstring
handlestringrequired
display_namestring | null
descriptionstring | null
avatar_urlstring (uri) | null
banner_urlstring (uri) | null
followers_countinteger | null
following_countinteger | null
posts_countinteger | null
labelsarray of string
is_botboolean
verifiedboolean
created_atstring (date-time) | null
indexed_atstring (date-time) | null
viewer_followingstring | null

follow record URI when the account follows them

viewer_followed_bystring | null
viewer_mutedboolean
viewer_blockingstring | null

block record URI

viewer_blocked_byboolean
allow_incoming_chatstring | null

allfollowingnone

urlstring (uri)
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/bluesky/mutes
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/mutes" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bluesky: Create a Muted accounts item

POST/accounts/{accountId}/bluesky/mutes

Mutes are private (app.bsky.graph.muteActor). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/mutes.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-mutes-create (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

actorstringrequired

handle or DID

Returns object

idstringrequired

DID

didstring
handlestringrequired
display_namestring | null
descriptionstring | null
avatar_urlstring (uri) | null
banner_urlstring (uri) | null
followers_countinteger | null
following_countinteger | null
posts_countinteger | null
labelsarray of string
is_botboolean
verifiedboolean
created_atstring (date-time) | null
indexed_atstring (date-time) | null
viewer_followingstring | null

follow record URI when the account follows them

viewer_followed_bystring | null
viewer_mutedboolean
viewer_blockingstring | null

block record URI

viewer_blocked_byboolean
allow_incoming_chatstring | null

allfollowingnone

urlstring (uri)

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/mutes
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/mutes" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "actor": "string"
  }'
Response · 201

Bluesky: Delete a Muted accounts item

DELETE/accounts/{accountId}/bluesky/mutes/{itemId}

Mutes are private (app.bsky.graph.muteActor). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/mutes.

Access: write

Try it with MCPAsk your agent to call bluesky-mutes-delete (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/bluesky/mutes/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/mutes/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Suggested follows

Bluesky: List Suggested accounts

GET/accounts/{accountId}/bluesky/suggested-follows

Cursor pagination: pass next_cursor back as cursor. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/suggested-follows.

Access: read

Try it with MCPAsk your agent to call bluesky-suggested-follows-list (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 50

1–100

cursorstring
similar_tostring

handle/DID: accounts similar to this one

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 22 item attributes
idstringrequired

DID

didstring
handlestringrequired
display_namestring | null
descriptionstring | null
avatar_urlstring (uri) | null
banner_urlstring (uri) | null
followers_countinteger | null
following_countinteger | null
posts_countinteger | null
labelsarray of string
is_botboolean
verifiedboolean
created_atstring (date-time) | null
indexed_atstring (date-time) | null
viewer_followingstring | null

follow record URI when the account follows them

viewer_followed_bystring | null
viewer_mutedboolean
viewer_blockingstring | null

block record URI

viewer_blocked_byboolean
allow_incoming_chatstring | null

allfollowingnone

urlstring (uri)
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/bluesky/suggested-follows
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/suggested-follows" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bluesky: Follow (Suggested accounts)

POST/accounts/{accountId}/bluesky/suggested-follows/{itemId}/follow

Follow. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/suggested-follows.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-suggested-follows-follow (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/suggested-follows/{itemId}/follow
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/suggested-follows/ITEM_ID/follow" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Bluesky: Mute (Suggested accounts)

POST/accounts/{accountId}/bluesky/suggested-follows/{itemId}/mute

Mute. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/suggested-follows.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-suggested-follows-mute (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/suggested-follows/{itemId}/mute
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/suggested-follows/ITEM_ID/mute" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Lists

Bluesky: List Lists

GET/accounts/{accountId}/bluesky/lists

Curation lists (feeds of people) and moderation lists (mute/block in bulk). Cursor pagination: pass next_cursor back as cursor. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/lists.

Access: read

Try it with MCPAsk your agent to call bluesky-lists-list (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 50

1–100

cursorstring
purposestring

curatemodreference

actorstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 14 item attributes
idstring

AT-URI

uristring
cidstring
namestring

≤ 64 characters

purposestring

curatemodreference

descriptionstring | null

≤ 300 graphemes

avatar_urlstring (uri) | null
member_countinteger | null
creator_handlestring | null
viewer_mutedboolean
viewer_blockedstring | null

listblock record URI when subscribed as a block list

labelsarray of string
indexed_atstring (date-time) | null
urlstring (uri) | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/bluesky/lists
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/lists" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bluesky: Create a Lists item

POST/accounts/{accountId}/bluesky/lists

Curation lists (feeds of people) and moderation lists (mute/block in bulk). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/lists.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-lists-create (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

namestringrequired
purposestringrequired

curatemod

descriptionstring
avatarstring

Returns object

idstring

AT-URI

uristring
cidstring
namestring

≤ 64 characters

purposestring

curatemodreference

descriptionstring | null

≤ 300 graphemes

avatar_urlstring (uri) | null
member_countinteger | null
creator_handlestring | null
viewer_mutedboolean
viewer_blockedstring | null

listblock record URI when subscribed as a block list

labelsarray of string
indexed_atstring (date-time) | null
urlstring (uri) | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/lists
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/lists" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "purpose": "curate",
    "description": "string",
    "avatar": "string"
  }'
Response · 201

Bluesky: Get a Lists item

GET/accounts/{accountId}/bluesky/lists/{itemId}

Curation lists (feeds of people) and moderation lists (mute/block in bulk). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/lists.

Access: read

Try it with MCPAsk your agent to call bluesky-lists-get (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstring

AT-URI

uristring
cidstring
namestring

≤ 64 characters

purposestring

curatemodreference

descriptionstring | null

≤ 300 graphemes

avatar_urlstring (uri) | null
member_countinteger | null
creator_handlestring | null
viewer_mutedboolean
viewer_blockedstring | null

listblock record URI when subscribed as a block list

labelsarray of string
indexed_atstring (date-time) | null
urlstring (uri) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/bluesky/lists/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/lists/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bluesky: Update a Lists item

PATCH/accounts/{accountId}/bluesky/lists/{itemId}

Curation lists (feeds of people) and moderation lists (mute/block in bulk). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/lists.

Access: write

Try it with MCPAsk your agent to call bluesky-lists-update (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

namestring
descriptionstring | null
avatarstring
remove_avatarboolean

Returns object

idstring

AT-URI

uristring
cidstring
namestring

≤ 64 characters

purposestring

curatemodreference

descriptionstring | null

≤ 300 graphemes

avatar_urlstring (uri) | null
member_countinteger | null
creator_handlestring | null
viewer_mutedboolean
viewer_blockedstring | null

listblock record URI when subscribed as a block list

labelsarray of string
indexed_atstring (date-time) | null
urlstring (uri) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/bluesky/lists/{itemId}
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/lists/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "description": "string",
    "avatar": "string",
    "remove_avatar": true
  }'
Response · 200

Bluesky: Delete a Lists item

DELETE/accounts/{accountId}/bluesky/lists/{itemId}

Delete the list and its member records. Curation lists (feeds of people) and moderation lists (mute/block in bulk). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/lists.

Access: write

Try it with MCPAsk your agent to call bluesky-lists-delete (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/bluesky/lists/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/lists/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bluesky: Subscribe as mute list (Lists)

POST/accounts/{accountId}/bluesky/lists/{itemId}/mute-list

Subscribe as mute list. Curation lists (feeds of people) and moderation lists (mute/block in bulk). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/lists.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-lists-mute-list (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/lists/{itemId}/mute-list
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/lists/ITEM_ID/mute-list" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Bluesky: Unsubscribe (mute) (Lists)

POST/accounts/{accountId}/bluesky/lists/{itemId}/unmute-list

Unsubscribe (mute). Curation lists (feeds of people) and moderation lists (mute/block in bulk). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/lists.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-lists-unmute-list (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/lists/{itemId}/unmute-list
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/lists/ITEM_ID/unmute-list" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Bluesky: Subscribe as block list (Lists)

POST/accounts/{accountId}/bluesky/lists/{itemId}/block-list

Subscribe as block list. Curation lists (feeds of people) and moderation lists (mute/block in bulk). Destructive. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/lists.

Access: write

Try it with MCPAsk your agent to call bluesky-lists-block-list (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/lists/{itemId}/block-list
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/lists/ITEM_ID/block-list" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Bluesky: Unsubscribe (block) (Lists)

POST/accounts/{accountId}/bluesky/lists/{itemId}/unblock-list

Unsubscribe (block). Curation lists (feeds of people) and moderation lists (mute/block in bulk). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/lists.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-lists-unblock-list (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/lists/{itemId}/unblock-list
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/lists/ITEM_ID/unblock-list" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

List members

Bluesky: List List members

GET/accounts/{accountId}/bluesky/list-members

Accounts in a list (app.bsky.graph.listitem records). Cursor pagination: pass next_cursor back as cursor. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/list-members.

Access: read

Try it with MCPAsk your agent to call bluesky-list-members-list (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 50

1–100

cursorstring
liststring

list AT-URI or URL

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 24 item attributes
idstring

listitem AT-URI

didstring
handlestring
display_namestring | null
descriptionstring | null
avatar_urlstring (uri) | null
banner_urlstring (uri) | null
followers_countinteger | null
following_countinteger | null
posts_countinteger | null
labelsarray of string
is_botboolean
verifiedboolean
created_atstring (date-time) | null
indexed_atstring (date-time) | null
viewer_followingstring | null

follow record URI when the account follows them

viewer_followed_bystring | null
viewer_mutedboolean
viewer_blockingstring | null

block record URI

viewer_blocked_byboolean
allow_incoming_chatstring | null

allfollowingnone

urlstring (uri)
listitem_uristring
list_uristring
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/bluesky/list-members
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/list-members" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bluesky: Create a List members item

POST/accounts/{accountId}/bluesky/list-members

Accounts in a list (app.bsky.graph.listitem records). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/list-members.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-list-members-create (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

liststringrequired
actorstringrequired

handle or DID

Returns object

idstring

listitem AT-URI

didstring
handlestring
display_namestring | null
descriptionstring | null
avatar_urlstring (uri) | null
banner_urlstring (uri) | null
followers_countinteger | null
following_countinteger | null
posts_countinteger | null
labelsarray of string
is_botboolean
verifiedboolean
created_atstring (date-time) | null
indexed_atstring (date-time) | null
viewer_followingstring | null

follow record URI when the account follows them

viewer_followed_bystring | null
viewer_mutedboolean
viewer_blockingstring | null

block record URI

viewer_blocked_byboolean
allow_incoming_chatstring | null

allfollowingnone

urlstring (uri)
listitem_uristring
list_uristring

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/list-members
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/list-members" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "list": "string",
    "actor": "string"
  }'
Response · 201

Bluesky: Delete a List members item

DELETE/accounts/{accountId}/bluesky/list-members/{itemId}

Remove a member (id = listitem AT-URI). Accounts in a list (app.bsky.graph.listitem records). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/list-members.

Access: write

Try it with MCPAsk your agent to call bluesky-list-members-delete (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/bluesky/list-members/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/list-members/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Starter packs

Bluesky: List Starter packs

GET/accounts/{accountId}/bluesky/starter-packs

Shareable bundles of accounts and up to 3 feeds (backed by a reference list). Cursor pagination: pass next_cursor back as cursor. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/starter-packs.

Access: read

Try it with MCPAsk your agent to call bluesky-starter-packs-list (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 50

1–100

cursorstring
actorstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 14 item attributes
idstring
uristring
cidstring
namestring

≤ 50 graphemes

descriptionstring | null
list_uristring
feedsarray of string

≤ 3 items

member_countinteger | null
joined_weekinteger | null
joined_all_timeinteger | null
creator_handlestring | null
members_samplearray of string
created_atstring (date-time) | null
urlstring (uri) | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/bluesky/starter-packs
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/starter-packs" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bluesky: Create a Starter packs item

POST/accounts/{accountId}/bluesky/starter-packs

Creates the reference list, its members and the starter pack in one applyWrites batch. Shareable bundles of accounts and up to 3 feeds (backed by a reference list). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/starter-packs.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-starter-packs-create (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

namestringrequired
descriptionstring
membersarray of string

≤ 150 items

feedsarray of string

≤ 3 items

Returns object

idstring
uristring
cidstring
namestring

≤ 50 graphemes

descriptionstring | null
list_uristring
feedsarray of string

≤ 3 items

member_countinteger | null
joined_weekinteger | null
joined_all_timeinteger | null
creator_handlestring | null
members_samplearray of string
created_atstring (date-time) | null
urlstring (uri) | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/starter-packs
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/starter-packs" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "description": "string",
    "members": [
      "string"
    ],
    "feeds": [
      "string"
    ]
  }'
Response · 201

Bluesky: Get a Starter packs item

GET/accounts/{accountId}/bluesky/starter-packs/{itemId}

Shareable bundles of accounts and up to 3 feeds (backed by a reference list). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/starter-packs.

Access: read

Try it with MCPAsk your agent to call bluesky-starter-packs-get (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstring
uristring
cidstring
namestring

≤ 50 graphemes

descriptionstring | null
list_uristring
feedsarray of string

≤ 3 items

member_countinteger | null
joined_weekinteger | null
joined_all_timeinteger | null
creator_handlestring | null
members_samplearray of string
created_atstring (date-time) | null
urlstring (uri) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/bluesky/starter-packs/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/starter-packs/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bluesky: Update a Starter packs item

PATCH/accounts/{accountId}/bluesky/starter-packs/{itemId}

Shareable bundles of accounts and up to 3 feeds (backed by a reference list). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/starter-packs.

Access: write

Try it with MCPAsk your agent to call bluesky-starter-packs-update (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

namestring
descriptionstring | null
feedsarray of string

≤ 3 items

Returns object

idstring
uristring
cidstring
namestring

≤ 50 graphemes

descriptionstring | null
list_uristring
feedsarray of string

≤ 3 items

member_countinteger | null
joined_weekinteger | null
joined_all_timeinteger | null
creator_handlestring | null
members_samplearray of string
created_atstring (date-time) | null
urlstring (uri) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/bluesky/starter-packs/{itemId}
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/starter-packs/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "description": "string",
    "feeds": [
      "string"
    ]
  }'
Response · 200

Bluesky: Delete a Starter packs item

DELETE/accounts/{accountId}/bluesky/starter-packs/{itemId}

Delete the starter pack, its list and members. Shareable bundles of accounts and up to 3 feeds (backed by a reference list). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/starter-packs.

Access: write

Try it with MCPAsk your agent to call bluesky-starter-packs-delete (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/bluesky/starter-packs/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/starter-packs/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bluesky: Add account (Starter packs)

POST/accounts/{accountId}/bluesky/starter-packs/{itemId}/add-member

Add account. Shareable bundles of accounts and up to 3 feeds (backed by a reference list). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/starter-packs.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-starter-packs-add-member (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

actorstringrequired

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/starter-packs/{itemId}/add-member
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/starter-packs/ITEM_ID/add-member" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "actor": "string"
  }'
Response · 200

Bluesky: Remove account (Starter packs)

POST/accounts/{accountId}/bluesky/starter-packs/{itemId}/remove-member

Remove account. Shareable bundles of accounts and up to 3 feeds (backed by a reference list). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/starter-packs.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-starter-packs-remove-member (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

actorstringrequired

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/starter-packs/{itemId}/remove-member
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/starter-packs/ITEM_ID/remove-member" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "actor": "string"
  }'
Response · 200

List subscriptions

Bluesky: List Subscribed mod lists

GET/accounts/{accountId}/bluesky/list-subscriptions

Moderation lists the account subscribes to as mute or block lists (getListMutes / getListBlocks). Cursor pagination: pass next_cursor back as cursor. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/list-subscriptions.

Access: read

Try it with MCPAsk your agent to call bluesky-list-subscriptions-list (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 50

1–100

cursorstring
typestringdefault: "mute"

muteblock

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 15 item attributes
idstring

AT-URI

uristring
cidstring
namestring

≤ 64 characters

purposestring

curatemodreference

descriptionstring | null

≤ 300 graphemes

avatar_urlstring (uri) | null
member_countinteger | null
creator_handlestring | null
viewer_mutedboolean
viewer_blockedstring | null

listblock record URI when subscribed as a block list

labelsarray of string
indexed_atstring (date-time) | null
urlstring (uri) | null
subscriptionstring

muteblock

limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/bluesky/list-subscriptions
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/list-subscriptions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bluesky: Delete a Subscribed mod lists item

DELETE/accounts/{accountId}/bluesky/list-subscriptions/{itemId}

Unsubscribe (mute and block). Moderation lists the account subscribes to as mute or block lists (getListMutes / getListBlocks). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/list-subscriptions.

Access: write

Try it with MCPAsk your agent to call bluesky-list-subscriptions-delete (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/bluesky/list-subscriptions/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/list-subscriptions/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Saved feeds

Bluesky: List Saved & pinned feeds

GET/accounts/{accountId}/bluesky/saved-feeds

The feeds and lists shown in the account’s Bluesky app (pinned ones appear as tabs). Cursor pagination: pass next_cursor back as cursor. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/saved-feeds.

Access: read

Try it with MCPAsk your agent to call bluesky-saved-feeds-list (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 10 item attributes
idstring

saved-feed item id

typestring

feedlisttimeline

valuestring

feed/list AT-URI or "following"

pinnedboolean
positioninteger
display_namestring | null
descriptionstring | null
avatar_urlstring (uri) | null
creator_handlestring | null
urlstring (uri) | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/bluesky/saved-feeds
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/saved-feeds" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bluesky: Create a Saved & pinned feeds item

POST/accounts/{accountId}/bluesky/saved-feeds

The feeds and lists shown in the account’s Bluesky app (pinned ones appear as tabs). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/saved-feeds.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-saved-feeds-create (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

uristringrequired

feed generator or list AT-URI / URL

pinnedboolean

Returns object

idstring

saved-feed item id

typestring

feedlisttimeline

valuestring

feed/list AT-URI or "following"

pinnedboolean
positioninteger
display_namestring | null
descriptionstring | null
avatar_urlstring (uri) | null
creator_handlestring | null
urlstring (uri) | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/saved-feeds
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/saved-feeds" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "uri": "string",
    "pinned": true
  }'
Response · 201

Bluesky: Update a Saved & pinned feeds item

PATCH/accounts/{accountId}/bluesky/saved-feeds/{itemId}

The feeds and lists shown in the account’s Bluesky app (pinned ones appear as tabs). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/saved-feeds.

Access: write

Try it with MCPAsk your agent to call bluesky-saved-feeds-update (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

pinnedbooleanrequired

Returns object

idstring

saved-feed item id

typestring

feedlisttimeline

valuestring

feed/list AT-URI or "following"

pinnedboolean
positioninteger
display_namestring | null
descriptionstring | null
avatar_urlstring (uri) | null
creator_handlestring | null
urlstring (uri) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/bluesky/saved-feeds/{itemId}
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/saved-feeds/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "pinned": true
  }'
Response · 200

Bluesky: Delete a Saved & pinned feeds item

DELETE/accounts/{accountId}/bluesky/saved-feeds/{itemId}

The feeds and lists shown in the account’s Bluesky app (pinned ones appear as tabs). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/saved-feeds.

Access: write

Try it with MCPAsk your agent to call bluesky-saved-feeds-delete (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/bluesky/saved-feeds/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/saved-feeds/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bluesky: Reorder (Saved & pinned feeds)

POST/accounts/{accountId}/bluesky/saved-feeds/reorder

Reorder. The feeds and lists shown in the account’s Bluesky app (pinned ones appear as tabs). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/saved-feeds.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-saved-feeds-reorder (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

idsarray of stringrequired

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/saved-feeds/reorder
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/saved-feeds/reorder" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "ids": [
      "string"
    ]
  }'
Response · 200

Feed generators

Bluesky: List Discover feeds

GET/accounts/{accountId}/bluesky/feed-generators

Suggested and searchable custom feeds; save, pin or like them. Cursor pagination: pass next_cursor back as cursor. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/feed-generators.

Access: read

Try it with MCPAsk your agent to call bluesky-feed-generators-list (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 50

1–100

cursorstring
qstring

search (app.bsky.unspecced.getPopularFeedGenerators)

actorstring

feeds created by this account

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 14 item attributes
idstring

AT-URI

uristring
cidstring
service_didstring | null
display_namestring
descriptionstring | null
avatar_urlstring (uri) | null
like_countinteger
creator_handlestring | null
accepts_interactionsboolean
content_modestring | null

contentModeUnspecifiedcontentModeVideo

viewer_likestring | null
labelsarray of string
urlstring (uri) | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/bluesky/feed-generators
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/feed-generators" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bluesky: Get a Discover feeds item

GET/accounts/{accountId}/bluesky/feed-generators/{itemId}

Suggested and searchable custom feeds; save, pin or like them. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/feed-generators.

Access: read

Try it with MCPAsk your agent to call bluesky-feed-generators-get (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstring

AT-URI

uristring
cidstring
service_didstring | null
display_namestring
descriptionstring | null
avatar_urlstring (uri) | null
like_countinteger
creator_handlestring | null
accepts_interactionsboolean
content_modestring | null

contentModeUnspecifiedcontentModeVideo

viewer_likestring | null
labelsarray of string
urlstring (uri) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/bluesky/feed-generators/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/feed-generators/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bluesky: Save (Discover feeds)

POST/accounts/{accountId}/bluesky/feed-generators/{itemId}/save

Save. Suggested and searchable custom feeds; save, pin or like them. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/feed-generators.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-feed-generators-save (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/feed-generators/{itemId}/save
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/feed-generators/ITEM_ID/save" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Bluesky: Pin (Discover feeds)

POST/accounts/{accountId}/bluesky/feed-generators/{itemId}/pin

Pin. Suggested and searchable custom feeds; save, pin or like them. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/feed-generators.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-feed-generators-pin (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/feed-generators/{itemId}/pin
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/feed-generators/ITEM_ID/pin" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Bluesky: Like feed (Discover feeds)

POST/accounts/{accountId}/bluesky/feed-generators/{itemId}/like

Like feed. Suggested and searchable custom feeds; save, pin or like them. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/feed-generators.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-feed-generators-like (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/feed-generators/{itemId}/like
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/feed-generators/ITEM_ID/like" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Bluesky: Unlike feed (Discover feeds)

POST/accounts/{accountId}/bluesky/feed-generators/{itemId}/unlike

Unlike feed. Suggested and searchable custom feeds; save, pin or like them. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/feed-generators.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-feed-generators-unlike (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/feed-generators/{itemId}/unlike
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/feed-generators/ITEM_ID/unlike" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Feed posts

Bluesky: List Feed viewer

GET/accounts/{accountId}/bluesky/feed-posts

Posts of any custom feed or list feed (app.bsky.feed.getFeed / getListFeed). Cursor pagination: pass next_cursor back as cursor. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Network docs: https://endpoints.bsky.app/ Generic route: /v1/accounts/{accountId}/focus/feed-posts.

Access: read

Try it with MCPAsk your agent to call bluesky-feed-posts-list (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 50

1–100

cursorstring
feedstring

feed generator or list AT-URI / URL

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 35 item attributes
idstringrequired

AT-URI

uristringrequired
cidstringrequired
rkeystring
urlstring (uri)
textstringrequired

≤ 3000 characters

created_atstring (date-time)
indexed_atstring (date-time) | null
langsarray of string
tagsarray of string
labelsarray of string
author_idstring
author_handlestring
author_namestring | null
author_avatarstring (uri) | null
is_ownboolean
is_replyboolean
parent_idstring | null
root_idstring | null
like_countinteger
repost_countinteger
reply_countinteger
quote_countinteger
bookmark_countinteger
embedobject | null
Show 7 child attributes
typestring

imagesvideoexternalrecordrecord_with_media

imagesarray of object
Show 3 item attributes
urlstring (uri)
thumbstring (uri)
altstring
playliststring (uri) | null
thumbnailstring (uri) | null
uristring (uri) | null
titlestring | null
record_uristring | null
viewer_likestring | null
viewer_repoststring | null
viewer_bookmarkedboolean
viewer_thread_mutedboolean
reply_disabledboolean
embedding_disabledboolean
pinnedboolean
reposted_bystring | null
threadgate_rulesarray of string | null
hidden_repliesarray of string
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/bluesky/feed-posts
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/feed-posts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

My feeds

Bluesky: List My feed generators

GET/accounts/{accountId}/bluesky/my-feeds

Publish/maintain custom feed listings (app.bsky.feed.generator). Requires running a feed-generator service. Cursor pagination: pass next_cursor back as cursor. Requires one of: include:app.bsky.authManageFeedDeclarations | transition:generic. Generic route: /v1/accounts/{accountId}/focus/my-feeds.

Access: read

Try it with MCPAsk your agent to call bluesky-my-feeds-list (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 50

1–100

cursorstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 14 item attributes
idstring

AT-URI

uristring
cidstring
service_didstring | null
display_namestring
descriptionstring | null
avatar_urlstring (uri) | null
like_countinteger
creator_handlestring | null
accepts_interactionsboolean
content_modestring | null

contentModeUnspecifiedcontentModeVideo

viewer_likestring | null
labelsarray of string
urlstring (uri) | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/bluesky/my-feeds
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/my-feeds" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bluesky: Create a My feed generators item

POST/accounts/{accountId}/bluesky/my-feeds

Publish/maintain custom feed listings (app.bsky.feed.generator). Requires running a feed-generator service. Requires one of: include:app.bsky.authManageFeedDeclarations | transition:generic. Generic route: /v1/accounts/{accountId}/focus/my-feeds.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-my-feeds-create (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

rkeystringrequired

short feed id used in the URL (create only)

pattern ^[a-zA-Z0-9-]{1,15}$

service_didstringrequired

did:web of the feed generator service

display_namestringrequired

≤ 24 graphemes

descriptionstring
avatarstring
accepts_interactionsboolean
content_modestring

unspecifiedvideo

Returns object

idstring

AT-URI

uristring
cidstring
service_didstring | null
display_namestring
descriptionstring | null
avatar_urlstring (uri) | null
like_countinteger
creator_handlestring | null
accepts_interactionsboolean
content_modestring | null

contentModeUnspecifiedcontentModeVideo

viewer_likestring | null
labelsarray of string
urlstring (uri) | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/my-feeds
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/my-feeds" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "rkey": "string",
    "service_did": "string",
    "display_name": "string",
    "description": "string",
    "avatar": "string"
  }'
Response · 201

Bluesky: Update a My feed generators item

PATCH/accounts/{accountId}/bluesky/my-feeds/{itemId}

Publish/maintain custom feed listings (app.bsky.feed.generator). Requires running a feed-generator service. Requires one of: include:app.bsky.authManageFeedDeclarations | transition:generic. Generic route: /v1/accounts/{accountId}/focus/my-feeds.

Access: write

Try it with MCPAsk your agent to call bluesky-my-feeds-update (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

rkeystring

short feed id used in the URL (create only)

pattern ^[a-zA-Z0-9-]{1,15}$

service_didstring

did:web of the feed generator service

display_namestring

≤ 24 graphemes

descriptionstring
avatarstring
accepts_interactionsboolean
content_modestring

unspecifiedvideo

Returns object

idstring

AT-URI

uristring
cidstring
service_didstring | null
display_namestring
descriptionstring | null
avatar_urlstring (uri) | null
like_countinteger
creator_handlestring | null
accepts_interactionsboolean
content_modestring | null

contentModeUnspecifiedcontentModeVideo

viewer_likestring | null
labelsarray of string
urlstring (uri) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/bluesky/my-feeds/{itemId}
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/my-feeds/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "rkey": "string",
    "service_did": "string",
    "display_name": "string",
    "description": "string",
    "avatar": "string"
  }'
Response · 200

Bluesky: Delete a My feed generators item

DELETE/accounts/{accountId}/bluesky/my-feeds/{itemId}

Publish/maintain custom feed listings (app.bsky.feed.generator). Requires running a feed-generator service. Requires one of: include:app.bsky.authManageFeedDeclarations | transition:generic. Generic route: /v1/accounts/{accountId}/focus/my-feeds.

Access: write

Try it with MCPAsk your agent to call bluesky-my-feeds-delete (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/bluesky/my-feeds/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/my-feeds/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Reports

Bluesky: Create a Report content item

POST/accounts/{accountId}/bluesky/reports

Report posts, lists, feeds or accounts to Bluesky moderation (or another labeler). Keep a record of reports — the developer guidelines require it. Requires one of: rpc:com.atproto.moderation.createReport?aud=* | transition:generic. Generic route: /v1/accounts/{accountId}/focus/reports.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-reports-create (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

subjectstringrequired

post/list/feed AT-URI or URL, or an account handle/DID

reason_typestringrequired

spamviolationmisleadingsexualrudeotherappeal

reasonstring

≤ 2000 characters

labelerstring

labeler DID (default Bluesky moderation)

Returns object

idinteger | null
reason_typestring
subjectobject
Show 2 child attributes
uristring
didstring
created_atstring (date-time)

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/reports
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/reports" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "subject": "string",
    "reason_type": "spam",
    "reason": "string",
    "labeler": "string"
  }'
Response · 201

Muted words

Bluesky: List Muted words & tags

GET/accounts/{accountId}/bluesky/muted-words

Cursor pagination: pass next_cursor back as cursor. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/muted-words.

Access: read

Try it with MCPAsk your agent to call bluesky-muted-words-list (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 5 item attributes
idstring
valuestring

word, phrase or tag (without #)

targetsarray of string
actor_targetstring

allexclude-following

expires_atstring (date-time) | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/bluesky/muted-words
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/muted-words" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bluesky: Create a Muted words & tags item

POST/accounts/{accountId}/bluesky/muted-words

Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/muted-words.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-muted-words-create (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

valuestringrequired
targetsarray of string
actor_targetstring

allexclude-following

expires_atstring (date-time) | null

Returns object

idstring
valuestring

word, phrase or tag (without #)

targetsarray of string
actor_targetstring

allexclude-following

expires_atstring (date-time) | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/muted-words
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/muted-words" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "value": "string",
    "targets": [
      "content"
    ],
    "actor_target": "all",
    "expires_at": "2026-10-13T09:00:00.000Z"
  }'
Response · 201

Bluesky: Update a Muted words & tags item

PATCH/accounts/{accountId}/bluesky/muted-words/{itemId}

Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/muted-words.

Access: write

Try it with MCPAsk your agent to call bluesky-muted-words-update (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

valuestring
targetsarray of string
actor_targetstring

allexclude-following

expires_atstring (date-time) | null

Returns object

idstring
valuestring

word, phrase or tag (without #)

targetsarray of string
actor_targetstring

allexclude-following

expires_atstring (date-time) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/bluesky/muted-words/{itemId}
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/muted-words/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "value": "string",
    "targets": [
      "content"
    ],
    "actor_target": "all",
    "expires_at": "2026-10-13T09:00:00.000Z"
  }'
Response · 200

Bluesky: Delete a Muted words & tags item

DELETE/accounts/{accountId}/bluesky/muted-words/{itemId}

Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/muted-words.

Access: write

Try it with MCPAsk your agent to call bluesky-muted-words-delete (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/bluesky/muted-words/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/muted-words/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Content filters

Bluesky: Get Content filters

GET/accounts/{accountId}/bluesky/content-filters

Adult content and how Bluesky moderation labels are shown (adultContentPref + contentLabelPref). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/content-filters.

Access: read

Try it with MCPAsk your agent to call bluesky-content-filters-get (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

adult_content_enabledboolean
labelsobject
Show 5 child attributes
pornstring

ignoreshowwarnhide

sexualstring

ignoreshowwarnhide

nuditystring

ignoreshowwarnhide

graphic-mediastring

ignoreshowwarnhide

gorestring

ignoreshowwarnhide

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/bluesky/content-filters
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/content-filters" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bluesky: Update Content filters

PATCH/accounts/{accountId}/bluesky/content-filters

Adult content and how Bluesky moderation labels are shown (adultContentPref + contentLabelPref). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/content-filters.

Access: write

Try it with MCPAsk your agent to call bluesky-content-filters-update (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

adult_content_enabledboolean
labelsobject
Show 5 child attributes
pornstring

ignoreshowwarnhide

sexualstring

ignoreshowwarnhide

nuditystring

ignoreshowwarnhide

graphic-mediastring

ignoreshowwarnhide

gorestring

ignoreshowwarnhide

Returns object

adult_content_enabledboolean
labelsobject
Show 5 child attributes
pornstring

ignoreshowwarnhide

sexualstring

ignoreshowwarnhide

nuditystring

ignoreshowwarnhide

graphic-mediastring

ignoreshowwarnhide

gorestring

ignoreshowwarnhide

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/bluesky/content-filters
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/content-filters" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "adult_content_enabled": true,
    "labels": {
      "porn": "ignore",
      "sexual": "ignore"
    }
  }'
Response · 200

Labelers

Bluesky: List Moderation services

GET/accounts/{accountId}/bluesky/labelers

Subscribed labelers (labelersPref). Bluesky’s own moderation always applies and cannot be removed. Cursor pagination: pass next_cursor back as cursor. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/labelers.

Access: read

Try it with MCPAsk your agent to call bluesky-labelers-list (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 9 item attributes
idstring
didstring
handlestring | null
display_namestring | null
descriptionstring | null
avatar_urlstring (uri) | null
like_countinteger
label_valuesarray of string
builtinboolean
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/bluesky/labelers
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/labelers" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bluesky: Create a Moderation services item

POST/accounts/{accountId}/bluesky/labelers

Subscribed labelers (labelersPref). Bluesky’s own moderation always applies and cannot be removed. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/labelers.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-labelers-create (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

didstringrequired

labeler account DID

Returns object

idstring
didstring
handlestring | null
display_namestring | null
descriptionstring | null
avatar_urlstring (uri) | null
like_countinteger
label_valuesarray of string
builtinboolean

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/labelers
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/labelers" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "did": "string"
  }'
Response · 201

Bluesky: Delete a Moderation services item

DELETE/accounts/{accountId}/bluesky/labelers/{itemId}

Subscribed labelers (labelersPref). Bluesky’s own moderation always applies and cannot be removed. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/labelers.

Access: write

Try it with MCPAsk your agent to call bluesky-labelers-delete (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/bluesky/labelers/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/labelers/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Hidden posts

Bluesky: List Hidden posts

GET/accounts/{accountId}/bluesky/hidden-posts

Posts hidden from the account’s feeds (hiddenPostsPref). Cursor pagination: pass next_cursor back as cursor. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/hidden-posts.

Access: read

Try it with MCPAsk your agent to call bluesky-hidden-posts-list (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 35 item attributes
idstringrequired

AT-URI

uristringrequired
cidstringrequired
rkeystring
urlstring (uri)
textstringrequired

≤ 3000 characters

created_atstring (date-time)
indexed_atstring (date-time) | null
langsarray of string
tagsarray of string
labelsarray of string
author_idstring
author_handlestring
author_namestring | null
author_avatarstring (uri) | null
is_ownboolean
is_replyboolean
parent_idstring | null
root_idstring | null
like_countinteger
repost_countinteger
reply_countinteger
quote_countinteger
bookmark_countinteger
embedobject | null
Show 7 child attributes
typestring

imagesvideoexternalrecordrecord_with_media

imagesarray of object
Show 3 item attributes
urlstring (uri)
thumbstring (uri)
altstring
playliststring (uri) | null
thumbnailstring (uri) | null
uristring (uri) | null
titlestring | null
record_uristring | null
viewer_likestring | null
viewer_repoststring | null
viewer_bookmarkedboolean
viewer_thread_mutedboolean
reply_disabledboolean
embedding_disabledboolean
pinnedboolean
reposted_bystring | null
threadgate_rulesarray of string | null
hidden_repliesarray of string
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/bluesky/hidden-posts
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/hidden-posts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bluesky: Create a Hidden posts item

POST/accounts/{accountId}/bluesky/hidden-posts

Posts hidden from the account’s feeds (hiddenPostsPref). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/hidden-posts.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-hidden-posts-create (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

uristringrequired

Returns object

idstringrequired

AT-URI

uristringrequired
cidstringrequired
rkeystring
urlstring (uri)
textstringrequired

≤ 3000 characters

created_atstring (date-time)
indexed_atstring (date-time) | null
langsarray of string
tagsarray of string
labelsarray of string
author_idstring
author_handlestring
author_namestring | null
author_avatarstring (uri) | null
is_ownboolean
is_replyboolean
parent_idstring | null
root_idstring | null
like_countinteger
repost_countinteger
reply_countinteger
quote_countinteger
bookmark_countinteger
embedobject | null
Show 7 child attributes
typestring

imagesvideoexternalrecordrecord_with_media

imagesarray of object
Show 3 item attributes
urlstring (uri)
thumbstring (uri)
altstring
playliststring (uri) | null
thumbnailstring (uri) | null
uristring (uri) | null
titlestring | null
record_uristring | null
viewer_likestring | null
viewer_repoststring | null
viewer_bookmarkedboolean
viewer_thread_mutedboolean
reply_disabledboolean
embedding_disabledboolean
pinnedboolean
reposted_bystring | null
threadgate_rulesarray of string | null
hidden_repliesarray of string

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/hidden-posts
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/hidden-posts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "uri": "string"
  }'
Response · 201

Bluesky: Delete a Hidden posts item

DELETE/accounts/{accountId}/bluesky/hidden-posts/{itemId}

Posts hidden from the account’s feeds (hiddenPostsPref). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/hidden-posts.

Access: write

Try it with MCPAsk your agent to call bluesky-hidden-posts-delete (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/bluesky/hidden-posts/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/hidden-posts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Search posts

Bluesky: List Search posts

GET/accounts/{accountId}/bluesky/search-posts

Social listening over Bluesky posts (app.bsky.feed.searchPosts; Lucene-like syntax, e.g. "from:alice.bsky.social #atproto"). Cursor pagination: pass next_cursor back as cursor. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/search-posts.

Access: read

Try it with MCPAsk your agent to call bluesky-search-posts-list (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

qstringrequired
sortstringdefault: "latest"

toplatest

sincestring (date-time)
untilstring (date-time)
authorstring
mentionsstring
langstring
domainstring
urlstring (uri)
tagarray of string
limitintegerdefault: 25

≤ 100

cursorstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 35 item attributes
idstringrequired

AT-URI

uristringrequired
cidstringrequired
rkeystring
urlstring (uri)
textstringrequired

≤ 3000 characters

created_atstring (date-time)
indexed_atstring (date-time) | null
langsarray of string
tagsarray of string
labelsarray of string
author_idstring
author_handlestring
author_namestring | null
author_avatarstring (uri) | null
is_ownboolean
is_replyboolean
parent_idstring | null
root_idstring | null
like_countinteger
repost_countinteger
reply_countinteger
quote_countinteger
bookmark_countinteger
embedobject | null
Show 7 child attributes
typestring

imagesvideoexternalrecordrecord_with_media

imagesarray of object
Show 3 item attributes
urlstring (uri)
thumbstring (uri)
altstring
playliststring (uri) | null
thumbnailstring (uri) | null
uristring (uri) | null
titlestring | null
record_uristring | null
viewer_likestring | null
viewer_repoststring | null
viewer_bookmarkedboolean
viewer_thread_mutedboolean
reply_disabledboolean
embedding_disabledboolean
pinnedboolean
reposted_bystring | null
threadgate_rulesarray of string | null
hidden_repliesarray of string
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/bluesky/search-posts
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/search-posts?q=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bluesky: Like (Search posts)

POST/accounts/{accountId}/bluesky/search-posts/{itemId}/like

Like. Social listening over Bluesky posts (app.bsky.feed.searchPosts; Lucene-like syntax, e.g. "from:alice.bsky.social #atproto"). Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/search-posts.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-search-posts-like (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/search-posts/{itemId}/like
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/search-posts/ITEM_ID/like" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Bluesky: Repost (Search posts)

POST/accounts/{accountId}/bluesky/search-posts/{itemId}/repost

Repost. Social listening over Bluesky posts (app.bsky.feed.searchPosts; Lucene-like syntax, e.g. "from:alice.bsky.social #atproto"). Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/search-posts.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-search-posts-repost (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/search-posts/{itemId}/repost
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/search-posts/ITEM_ID/repost" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Search accounts

Bluesky: List Search accounts

GET/accounts/{accountId}/bluesky/search-accounts

Cursor pagination: pass next_cursor back as cursor. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/search-accounts.

Access: read

Try it with MCPAsk your agent to call bluesky-search-accounts-list (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

qstringrequired
typeaheadboolean
limitintegerdefault: 25
cursorstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 22 item attributes
idstringrequired

DID

didstring
handlestringrequired
display_namestring | null
descriptionstring | null
avatar_urlstring (uri) | null
banner_urlstring (uri) | null
followers_countinteger | null
following_countinteger | null
posts_countinteger | null
labelsarray of string
is_botboolean
verifiedboolean
created_atstring (date-time) | null
indexed_atstring (date-time) | null
viewer_followingstring | null

follow record URI when the account follows them

viewer_followed_bystring | null
viewer_mutedboolean
viewer_blockingstring | null

block record URI

viewer_blocked_byboolean
allow_incoming_chatstring | null

allfollowingnone

urlstring (uri)
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/bluesky/search-accounts
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/search-accounts?q=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bluesky: Follow (Search accounts)

POST/accounts/{accountId}/bluesky/search-accounts/{itemId}/follow

Follow. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/search-accounts.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-search-accounts-follow (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/search-accounts/{itemId}/follow
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/search-accounts/ITEM_ID/follow" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Bluesky: Mute (Search accounts)

POST/accounts/{accountId}/bluesky/search-accounts/{itemId}/mute

Mute. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/search-accounts.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call bluesky-search-accounts-mute (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/bluesky/search-accounts/{itemId}/mute
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/search-accounts/ITEM_ID/mute" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Search starter packs

Bluesky: List Search starter packs

GET/accounts/{accountId}/bluesky/search-starter-packs

Cursor pagination: pass next_cursor back as cursor. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/search-starter-packs.

Access: read

Try it with MCPAsk your agent to call bluesky-search-starter-packs-list (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

qstringrequired
limitintegerdefault: 25
cursorstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 8 item attributes
idstring
uristring
namestring
descriptionstring | null
member_countinteger | null
joined_all_timeinteger | null
creator_handlestring | null
urlstring (uri) | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/bluesky/search-starter-packs
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/search-starter-packs?q=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Analytics overview

Bluesky: Get Overview

GET/accounts/{accountId}/bluesky/analytics-overview

Pass ?since&until; the API supplies stored snapshots as ctx.snapshots. Followers, following and posts with follower growth from daily snapshots, plus engagement on recent posts. Bluesky has no impressions or views. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/analytics-overview.

Access: read

Try it with MCPAsk your agent to call bluesky-analytics-overview-get (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

followersinteger
followinginteger
posts_countinteger
seriesarray of object
Show 2 item attributes
datestring (date)
metricsobject
Show 3 child attributes
followersinteger
followinginteger
follower_changeinteger
totalsobject
Show 3 child attributes
followersinteger
followinginteger
follower_changeinteger
recent_engagementobject
Show 7 child attributes
postsinteger
likesinteger
sharesinteger
commentsinteger
quotesinteger
savesinteger
engagementsinteger

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/bluesky/analytics-overview
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/analytics-overview" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Post analytics

Bluesky: List Post performance

GET/accounts/{accountId}/bluesky/post-analytics

Likes, reposts, replies, quotes and bookmarks per recent post. Cursor pagination: pass next_cursor back as cursor. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: /v1/accounts/{accountId}/focus/post-analytics.

Access: read

Try it with MCPAsk your agent to call bluesky-post-analytics-list (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

sortstringdefault: "recent"

recenttop

limitintegerdefault: 50

≤ 200

sincestring (date-time)
untilstring (date-time)

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 10 item attributes
idstring
created_atstring (date-time)
textstring
like_countinteger
repost_countinteger
reply_countinteger
quote_countinteger
bookmark_countinteger
engagementsinteger
urlstring (uri)
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/bluesky/post-analytics
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/post-analytics" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Video limits

Bluesky: Get Video quota

GET/accounts/{accountId}/bluesky/video-limits

Remaining daily video uploads and bytes (app.bsky.video.getUploadLimits). Bluesky-hosted accounts need a verified email. Requires one of: rpc:com.atproto.repo.uploadBlob?aud=* + rpc:app.bsky.video.getUploadLimits?aud=* | transition:generic. Generic route: /v1/accounts/{accountId}/focus/video-limits.

Access: read

Try it with MCPAsk your agent to call bluesky-video-limits-get (toolset focus_bluesky)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

can_uploadboolean
remaining_daily_videosinteger | null
remaining_daily_bytesinteger | null
messagestring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/bluesky/video-limits
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/video-limits" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200