# Focus · Bluesky API

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

Base URL: `https://api.socialit.com/v1`. Authenticate with `Authorization: Bearer <API key or OAuth token>`.

## 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` · MCP tool: `bluesky-profile-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/profile" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "did": "string",
  "handle": "string",
  "display_name": "string",
  "description": "string",
  "pronouns": "string",
  "website": "https://example.com",
  "avatar_url": "https://example.com",
  "banner_url": "https://example.com",
  "followers_count": 1,
  "following_count": 1,
  "posts_count": 1,
  "pinned_post": "string",
  "self_labels": [
    "porn"
  ],
  "verified": true,
  "created_at": "2026-10-13T09:00:00.000Z",
  "url": "https://example.com"
}
```

## 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` · MCP tool: `bluesky-profile-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Body

- `display_name` (string | null)
- `description` (string | null)
- `pronouns` (string | null)
- `website` (string (uri) | null)
- `avatar` (string): png/jpeg ≤ 1 MB (media id or URL)
- `banner` (string): png/jpeg ≤ 1 MB, 3:1
- `remove_avatar` (boolean)
- `remove_banner` (boolean)
- `pinned_post` (string | null): AT-URI or bsky.app URL; null unpins
- `self_labels` (array of string)

```bash
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:

```json
{
  "id": "string",
  "did": "string",
  "handle": "string",
  "display_name": "string",
  "description": "string",
  "pronouns": "string",
  "website": "https://example.com",
  "avatar_url": "https://example.com",
  "banner_url": "https://example.com",
  "followers_count": 1,
  "following_count": 1,
  "posts_count": 1,
  "pinned_post": "string",
  "self_labels": [
    "porn"
  ],
  "verified": true,
  "created_at": "2026-10-13T09:00:00.000Z",
  "url": "https://example.com"
}
```

## 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: `write` · MCP tool: `bluesky-profile-pin-post`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `uri` (string; required)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `bluesky-profile-unpin-post`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `bluesky-profile-set-bot-label`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `enabled` (boolean; required)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `bluesky-account-status-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/account-status" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "did": "string",
  "handle": "string",
  "active": true,
  "status": "string",
  "email": "you@example.com",
  "email_confirmed": true,
  "pds_url": "https://example.com",
  "auth_mode": "oauth",
  "granted_scopes": [
    "string"
  ]
}
```

## 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: `write` · MCP tool: `bluesky-account-status-update-handle`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `handle` (string; required): Domain with _atproto TXT or /.well-known/atproto-did already set up

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `bluesky-discoverability-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/discoverability" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "hide_from_algorithmic_recommendations": true
}
```

## 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` · MCP tool: `bluesky-discoverability-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Body

- `hide_from_algorithmic_recommendations` (boolean; required)

```bash
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:

```json
{
  "hide_from_algorithmic_recommendations": true
}
```

## 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` · MCP tool: `bluesky-activity-subscription-policy-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/activity-subscription-policy" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "allow_subscriptions": "followers"
}
```

## 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` · MCP tool: `bluesky-activity-subscription-policy-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Body

- `allow_subscriptions` (string; required; one of followers, mutuals, none)

```bash
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:

```json
{
  "allow_subscriptions": "followers"
}
```

## 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: `read` · MCP tool: `bluesky-posting-defaults-get` · Zernio: `GET /v1/accounts/{accountId}/bluesky-settings`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/posting-defaults" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "defaultLangs": [
    "string"
  ],
  "defaultThreadgate": [
    "string"
  ],
  "defaultPostgate": {
    "disableQuotes": true
  },
  "defaultLabels": [
    "porn"
  ],
  "defaultTags": [
    "string"
  ],
  "autoFacets": true,
  "autoLinkCards": true
}
```

## 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: `write` · MCP tool: `bluesky-posting-defaults-update` · Zernio: `PATCH /v1/accounts/{accountId}/bluesky-settings`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Body

- `defaultLangs` (array of string | null; 1–3 items): Languages written to every new post (langs). null = unset (Bluesky guesses).
- `defaultThreadgate` (array of string | null; ≤ 5 items): Default reply controls. null = everyone can reply; [] = nobody; otherwise any of mentioned, followers, following, list:.
- `defaultPostgate` (object | null): Default quote controls. null = quotes allowed.
  - `defaultPostgate.disableQuotes` (boolean)
- `defaultLabels` (array of string; ≤ 10 items): Self-labels (content warnings) applied to every new post.
- `defaultTags` (array of string; ≤ 8 items): Extra hidden hashtags (tags) added to every new post.
- `autoFacets` (boolean): Detect links, @mentions and #hashtags (default true).
- `autoLinkCards` (boolean): Build a link card from the first link when the post has no media (default true).

```bash
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:

```json
{
  "defaultLangs": [
    "string"
  ],
  "defaultThreadgate": [
    "string"
  ],
  "defaultPostgate": {
    "disableQuotes": true
  },
  "defaultLabels": [
    "porn"
  ],
  "defaultTags": [
    "string"
  ],
  "autoFacets": true,
  "autoLinkCards": true
}
```

## 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: `read` · MCP tool: `bluesky-posts-list` · Zernio: `GET /v1/accounts/{accountId}/posts`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–100)
- `cursor` (string)
- `filter` (string; one of posts_with_replies, posts_no_replies, posts_with_media, posts_and_author_threads, posts_with_video)
- `actor` (string): defaults to the account
- `include_pins` (boolean)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/posts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "uri": "string",
      "cid": "string",
      "rkey": "string",
      "url": "https://example.com",
      "text": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "indexed_at": "2026-10-13T09:00:00.000Z",
      "langs": [
        "string"
      ],
      "tags": [
        "string"
      ],
      "labels": [
        "string"
      ],
      "author_id": "string",
      "author_handle": "string",
      "author_name": "string",
      "author_avatar": "https://example.com",
      "is_own": true,
      "is_reply": true,
      "parent_id": "string",
      "root_id": "string",
      "like_count": 1,
      "repost_count": 1,
      "reply_count": 1,
      "quote_count": 1,
      "bookmark_count": 1,
      "embed": {
        "type": "images",
        "images": [
          {
            "url": null,
            "thumb": null,
            "alt": null
          }
        ],
        "playlist": "https://example.com",
        "thumbnail": "https://example.com",
        "uri": "https://example.com",
        "title": "string"
      },
      "viewer_like": "string",
      "viewer_repost": "string",
      "viewer_bookmarked": true,
      "viewer_thread_muted": true,
      "reply_disabled": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `bluesky-posts-create` · Zernio: `POST /v1/posts/{postId}/unpublish`, `POST /v1/inbox/posts/{postId}/like`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `text` (string): ≤ 300 graphemes / 3000 bytes; links, @mentions and #tags become facets
- `media` (array of object; ≤ 4 items)
  - `media[].media` (string): Socialit media id or public URL
  - `media[].alt_text` (string; ≤ 2000 characters)
  - `media[].captions` (array of object)
    - `media[].captions[].media` (string)
    - `media[].captions[].lang` (string)
- `thread` (array of object): Additional posts of a thread (after the root)
  - `thread[].text` (string)
  - `thread[].media` (array of object; ≤ 4 items)
    - `thread[].media[].media` (string): Socialit media id or public URL
    - `thread[].media[].alt_text` (string; ≤ 2000 characters)
    - `thread[].media[].captions` (array of object)
      - `thread[].media[].captions[].media` (string)
      - `thread[].media[].captions[].lang` (string)
- `langs` (array of string; ≤ 3 items)
- `labels` (array of string)
- `tags` (array of string; ≤ 8 items)
- `threadgate` (array of string | null; ≤ 5 items): [] = nobody; null = everyone
- `disable_quotes` (boolean)
- `quote` (string): AT-URI / URL of a post, list, feed or starter pack
- `reply_to` (string): AT-URI / URL of the post to reply to
- `link_card` (object | null)
  - `link_card.url` (string (uri))
  - `link_card.title` (string)
  - `link_card.description` (string)
- `first_comment` (string)
- `video_presentation` (string; one of default, gif)

```bash
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:

```json
{
  "id": "string",
  "uri": "string",
  "cid": "string",
  "rkey": "string",
  "url": "https://example.com",
  "text": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "indexed_at": "2026-10-13T09:00:00.000Z",
  "langs": [
    "string"
  ],
  "tags": [
    "string"
  ],
  "labels": [
    "string"
  ],
  "author_id": "string",
  "author_handle": "string",
  "author_name": "string",
  "author_avatar": "https://example.com",
  "is_own": true,
  "is_reply": true,
  "parent_id": "string",
  "root_id": "string",
  "like_count": 1,
  "repost_count": 1,
  "reply_count": 1,
  "quote_count": 1,
  "bookmark_count": 1,
  "embed": {
    "type": "images",
    "images": [
      {
        "url": "https://example.com",
        "thumb": "https://example.com",
        "alt": "string"
      }
    ],
    "playlist": "https://example.com",
    "thumbnail": "https://example.com",
    "uri": "https://example.com",
    "title": "string",
    "record_uri": "string"
  },
  "viewer_like": "string",
  "viewer_repost": "string",
  "viewer_bookmarked": true,
  "viewer_thread_muted": true,
  "reply_disabled": true,
  "embedding_disabled": true,
  "pinned": true,
  "reposted_by": "string",
  "threadgate_rules": [
    "string"
  ],
  "hidden_replies": [
    "string"
  ]
}
```

## 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` · MCP tool: `bluesky-posts-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/posts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "uri": "string",
  "cid": "string",
  "rkey": "string",
  "url": "https://example.com",
  "text": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "indexed_at": "2026-10-13T09:00:00.000Z",
  "langs": [
    "string"
  ],
  "tags": [
    "string"
  ],
  "labels": [
    "string"
  ],
  "author_id": "string",
  "author_handle": "string",
  "author_name": "string",
  "author_avatar": "https://example.com",
  "is_own": true,
  "is_reply": true,
  "parent_id": "string",
  "root_id": "string",
  "like_count": 1,
  "repost_count": 1,
  "reply_count": 1,
  "quote_count": 1,
  "bookmark_count": 1,
  "embed": {
    "type": "images",
    "images": [
      {
        "url": "https://example.com",
        "thumb": "https://example.com",
        "alt": "string"
      }
    ],
    "playlist": "https://example.com",
    "thumbnail": "https://example.com",
    "uri": "https://example.com",
    "title": "string",
    "record_uri": "string"
  },
  "viewer_like": "string",
  "viewer_repost": "string",
  "viewer_bookmarked": true,
  "viewer_thread_muted": true,
  "reply_disabled": true,
  "embedding_disabled": true,
  "pinned": true,
  "reposted_by": "string",
  "threadgate_rules": [
    "string"
  ],
  "hidden_replies": [
    "string"
  ]
}
```

## 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: `write` · MCP tool: `bluesky-posts-delete` · Zernio: `DELETE /v1/inbox/posts/{postId}/like`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/posts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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: `write` · MCP tool: `bluesky-posts-like`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `bluesky-posts-unlike`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `bluesky-posts-repost`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `bluesky-posts-unrepost`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `bluesky-posts-bookmark`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `bluesky-posts-unbookmark`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `bluesky-posts-pin`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `bluesky-posts-mute-thread`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `bluesky-posts-unmute-thread`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `bluesky-posts-set-reply-controls`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `allow` (array of string | null; ≤ 5 items)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `bluesky-posts-set-quote-controls`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `disable_quotes` (boolean; required)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `bluesky-posts-detach-quote`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `quote_uri` (string; required)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `bluesky-posts-reattach-quote`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `quote_uri` (string; required)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `bluesky-posts-report`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `reason_type` (string; one of spam, violation, misleading, sexual, rude, other)
- `reason` (string)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `read` · MCP tool: `bluesky-replies-list` · Zernio: `GET /v1/inbox/comments/{postId}`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `post` (string; required): AT-URI or URL of the thread root/post
- `depth` (integer; 1–10)
- `limit` (integer)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/replies?post=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "text": "string",
      "author": "string",
      "author_id": "string",
      "author_name": "string",
      "author_avatar": "https://example.com",
      "created_at": "2026-10-13T09:00:00.000Z",
      "like_count": 1,
      "reply_count": 1,
      "repost_count": 1,
      "quote_count": 1,
      "parent_id": "string",
      "root_id": "string",
      "depth": 1,
      "liked": true,
      "like_uri": "string",
      "hidden": true,
      "is_own": true,
      "url": "https://example.com"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `bluesky-replies-create` · Zernio: `POST /v1/inbox/comments/{postId}`, `POST /v1/inbox/comments/{postId}/{commentId}/hide`, `POST /v1/inbox/comments/{postId}/{commentId}/like`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `parent` (string; required): AT-URI of the post/reply to answer
- `text` (string; required)

```bash
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:

```json
{
  "id": "string",
  "text": "string",
  "author": "string",
  "author_id": "string",
  "author_name": "string",
  "author_avatar": "https://example.com",
  "created_at": "2026-10-13T09:00:00.000Z",
  "like_count": 1,
  "reply_count": 1,
  "repost_count": 1,
  "quote_count": 1,
  "parent_id": "string",
  "root_id": "string",
  "depth": 1,
  "liked": true,
  "like_uri": "string",
  "hidden": true,
  "is_own": true,
  "url": "https://example.com"
}
```

## 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: `write` · MCP tool: `bluesky-replies-delete` · Zernio: `DELETE /v1/inbox/comments/{postId}`, `DELETE /v1/inbox/comments/{postId}/{commentId}/hide`, `DELETE /v1/inbox/comments/{postId}/{commentId}/like`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/replies/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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: `write` · MCP tool: `bluesky-replies-hide`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `bluesky-replies-unhide`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `bluesky-replies-like`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `bluesky-replies-unlike`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `bluesky-replies-block-author`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `bluesky-replies-mute-author`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `bluesky-replies-report`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `reason_type` (string; one of spam, violation, misleading, sexual, rude, other)
- `reason` (string)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `bluesky-drafts-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–100)
- `cursor` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/drafts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "posts": [
        {
          "text": "string"
        }
      ],
      "langs": [
        "string"
      ],
      "threadgate": [
        "string"
      ],
      "disable_quotes": true,
      "created_at": "2026-10-13T09:00:00.000Z",
      "updated_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `bluesky-drafts-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `posts` (array of object)
  - `posts[].text` (string)
- `langs` (array of string)
- `threadgate` (array of string | null)
- `disable_quotes` (boolean)

```bash
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:

```json
{
  "id": "string",
  "posts": [
    {
      "text": "string"
    }
  ],
  "langs": [
    "string"
  ],
  "threadgate": [
    "string"
  ],
  "disable_quotes": true,
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## 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` · MCP tool: `bluesky-drafts-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `posts` (array of object)
  - `posts[].text` (string)
- `langs` (array of string)
- `threadgate` (array of string | null)
- `disable_quotes` (boolean)

```bash
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:

```json
{
  "id": "string",
  "posts": [
    {
      "text": "string"
    }
  ],
  "langs": [
    "string"
  ],
  "threadgate": [
    "string"
  ],
  "disable_quotes": true,
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## 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` · MCP tool: `bluesky-drafts-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/drafts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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: `write` · MCP tool: `bluesky-drafts-publish`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `posts` (array of object; required)
  - `posts[].text` (string)
- `langs` (array of string)
- `threadgate` (array of string | null)
- `disable_quotes` (boolean)
- `keep_draft` (boolean)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `bluesky-timeline-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–100)
- `cursor` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/timeline" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "uri": "string",
      "cid": "string",
      "rkey": "string",
      "url": "https://example.com",
      "text": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "indexed_at": "2026-10-13T09:00:00.000Z",
      "langs": [
        "string"
      ],
      "tags": [
        "string"
      ],
      "labels": [
        "string"
      ],
      "author_id": "string",
      "author_handle": "string",
      "author_name": "string",
      "author_avatar": "https://example.com",
      "is_own": true,
      "is_reply": true,
      "parent_id": "string",
      "root_id": "string",
      "like_count": 1,
      "repost_count": 1,
      "reply_count": 1,
      "quote_count": 1,
      "bookmark_count": 1,
      "embed": {
        "type": "images",
        "images": [
          {
            "url": null,
            "thumb": null,
            "alt": null
          }
        ],
        "playlist": "https://example.com",
        "thumbnail": "https://example.com",
        "uri": "https://example.com",
        "title": "string"
      },
      "viewer_like": "string",
      "viewer_repost": "string",
      "viewer_bookmarked": true,
      "viewer_thread_muted": true,
      "reply_disabled": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `bluesky-timeline-like`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `bluesky-timeline-repost`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `bluesky-timeline-bookmark`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `read` · MCP tool: `bluesky-notifications-list` · Zernio: `GET /v1/inbox/mentions`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–100)
- `cursor` (string)
- `reasons` (array of string)
- `priority` (boolean)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/notifications" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "type": "like",
      "reason_subject": "string",
      "text": "string",
      "author": "string",
      "author_id": "string",
      "author_name": "string",
      "author_avatar": "https://example.com",
      "created_at": "2026-10-13T09:00:00.000Z",
      "is_read": true,
      "parent_id": "string",
      "root_id": "string",
      "url": "https://example.com"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `bluesky-notifications-mark-seen`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `seen_at` (string (date-time))

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `bluesky-notifications-unread-count`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `bluesky-notifications-reply`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `text` (string; required)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `read` · MCP tool: `bluesky-conversations-list` · Zernio: `GET /v1/inbox/conversations`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–100)
- `cursor` (string)
- `status` (string; one of request, accepted)
- `unread_only` (boolean)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/conversations" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "title": "string",
      "participants": [
        {
          "id": "string",
          "name": "string",
          "username": "string",
          "avatar_url": "https://example.com",
          "is_self": true
        }
      ],
      "last_message": "string",
      "updated_at": "2026-10-13T09:00:00.000Z",
      "unread_count": 1,
      "status": "request",
      "muted": true,
      "kind": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `bluesky-conversations-create` · Zernio: `POST /v1/inbox/conversations`, `POST /v1/inbox/conversations/{conversationId}/accept`, `POST /v1/inbox/conversations/{conversationId}/read`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `participant` (string; required): handle or DID
- `text` (string)

```bash
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:

```json
{
  "id": "string",
  "title": "string",
  "participants": [
    {
      "id": "string",
      "name": "string",
      "username": "string",
      "avatar_url": "https://example.com",
      "is_self": true
    }
  ],
  "last_message": "string",
  "updated_at": "2026-10-13T09:00:00.000Z",
  "unread_count": 1,
  "status": "request",
  "muted": true,
  "kind": "string"
}
```

## 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: `read` · MCP tool: `bluesky-conversations-get` · Zernio: `GET /v1/inbox/conversations/{conversationId}`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/conversations/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "title": "string",
  "participants": [
    {
      "id": "string",
      "name": "string",
      "username": "string",
      "avatar_url": "https://example.com",
      "is_self": true
    }
  ],
  "last_message": "string",
  "updated_at": "2026-10-13T09:00:00.000Z",
  "unread_count": 1,
  "status": "request",
  "muted": true,
  "kind": "string"
}
```

## 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` · MCP tool: `bluesky-conversations-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/conversations/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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: `write` · MCP tool: `bluesky-conversations-accept`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `bluesky-conversations-mark-read`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `bluesky-conversations-mute`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `bluesky-conversations-unmute`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `bluesky-conversations-mark-all-read`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `status` (string; one of request, accepted)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `read` · MCP tool: `bluesky-messages-list` · Zernio: `GET /v1/inbox/conversations/{conversationId}/messages`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–100)
- `cursor` (string)
- `conversation` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/messages" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "message_id": "string",
      "conversation_id": "string",
      "text": "string",
      "direction": "in",
      "from_id": "string",
      "sent_at": "2026-10-13T09:00:00.000Z",
      "deleted": true,
      "reactions": [
        {
          "value": "string",
          "from_id": "string"
        }
      ],
      "embed_uri": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `bluesky-messages-create` · Zernio: `POST /v1/inbox/conversations/{conversationId}/messages`, `POST /v1/inbox/conversations/{conversationId}/messages/{messageId}/reactions`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `conversation` (string; required): conversation id, or a handle/DID to DM
- `text` (string; required): ≤ 1000 graphemes
- `embed_uri` (string): post to embed

```bash
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:

```json
{
  "id": "string",
  "message_id": "string",
  "conversation_id": "string",
  "text": "string",
  "direction": "in",
  "from_id": "string",
  "sent_at": "2026-10-13T09:00:00.000Z",
  "deleted": true,
  "reactions": [
    {
      "value": "string",
      "from_id": "string"
    }
  ],
  "embed_uri": "string"
}
```

## 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: `write` · MCP tool: `bluesky-messages-delete` · Zernio: `DELETE /v1/inbox/conversations/{conversationId}/messages/{messageId}`, `DELETE /v1/inbox/conversations/{conversationId}/messages/{messageId}/reactions`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/messages/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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: `write` · MCP tool: `bluesky-messages-react`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `value` (string; required): one emoji

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `bluesky-messages-unreact`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `value` (string; required)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `bluesky-notification-preferences-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/notification-preferences" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "chat": {
    "include": "all",
    "list": true,
    "push": true
  },
  "follow": {
    "include": "all",
    "list": true,
    "push": true
  },
  "like": {
    "include": "all",
    "list": true,
    "push": true
  },
  "likeViaRepost": {
    "include": "all",
    "list": true,
    "push": true
  },
  "mention": {
    "include": "all",
    "list": true,
    "push": true
  },
  "quote": {
    "include": "all",
    "list": true,
    "push": true
  },
  "reply": {
    "include": "all",
    "list": true,
    "push": true
  },
  "repost": {
    "include": "all",
    "list": true,
    "push": true
  },
  "repostViaRepost": {
    "include": "all",
    "list": true,
    "push": true
  },
  "starterpackJoined": {
    "include": "all",
    "list": true,
    "push": true
  },
  "subscribedPost": {
    "include": "all",
    "list": true,
    "push": true
  },
  "unverified": {
    "include": "all",
    "list": true,
    "push": true
  },
  "verified": {
    "include": "all",
    "list": true,
    "push": true
  }
}
```

## 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` · MCP tool: `bluesky-notification-preferences-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Body

- `chat` (object)
  - `chat.include` (string; one of all, follows, accepted)
  - `chat.list` (boolean)
  - `chat.push` (boolean)
- `follow` (object)
  - `follow.include` (string; one of all, follows, accepted)
  - `follow.list` (boolean)
  - `follow.push` (boolean)
- `like` (object)
  - `like.include` (string; one of all, follows, accepted)
  - `like.list` (boolean)
  - `like.push` (boolean)
- `likeViaRepost` (object)
  - `likeViaRepost.include` (string; one of all, follows, accepted)
  - `likeViaRepost.list` (boolean)
  - `likeViaRepost.push` (boolean)
- `mention` (object)
  - `mention.include` (string; one of all, follows, accepted)
  - `mention.list` (boolean)
  - `mention.push` (boolean)
- `quote` (object)
  - `quote.include` (string; one of all, follows, accepted)
  - `quote.list` (boolean)
  - `quote.push` (boolean)
- `reply` (object)
  - `reply.include` (string; one of all, follows, accepted)
  - `reply.list` (boolean)
  - `reply.push` (boolean)
- `repost` (object)
  - `repost.include` (string; one of all, follows, accepted)
  - `repost.list` (boolean)
  - `repost.push` (boolean)
- `repostViaRepost` (object)
  - `repostViaRepost.include` (string; one of all, follows, accepted)
  - `repostViaRepost.list` (boolean)
  - `repostViaRepost.push` (boolean)
- `starterpackJoined` (object)
  - `starterpackJoined.include` (string; one of all, follows, accepted)
  - `starterpackJoined.list` (boolean)
  - `starterpackJoined.push` (boolean)
- `subscribedPost` (object)
  - `subscribedPost.include` (string; one of all, follows, accepted)
  - `subscribedPost.list` (boolean)
  - `subscribedPost.push` (boolean)
- `unverified` (object)
  - `unverified.include` (string; one of all, follows, accepted)
  - `unverified.list` (boolean)
  - `unverified.push` (boolean)
- `verified` (object)
  - `verified.include` (string; one of all, follows, accepted)
  - `verified.list` (boolean)
  - `verified.push` (boolean)

```bash
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:

```json
{
  "chat": {
    "include": "all",
    "list": true,
    "push": true
  },
  "follow": {
    "include": "all",
    "list": true,
    "push": true
  },
  "like": {
    "include": "all",
    "list": true,
    "push": true
  },
  "likeViaRepost": {
    "include": "all",
    "list": true,
    "push": true
  },
  "mention": {
    "include": "all",
    "list": true,
    "push": true
  },
  "quote": {
    "include": "all",
    "list": true,
    "push": true
  },
  "reply": {
    "include": "all",
    "list": true,
    "push": true
  },
  "repost": {
    "include": "all",
    "list": true,
    "push": true
  },
  "repostViaRepost": {
    "include": "all",
    "list": true,
    "push": true
  },
  "starterpackJoined": {
    "include": "all",
    "list": true,
    "push": true
  },
  "subscribedPost": {
    "include": "all",
    "list": true,
    "push": true
  },
  "unverified": {
    "include": "all",
    "list": true,
    "push": true
  },
  "verified": {
    "include": "all",
    "list": true,
    "push": true
  }
}
```

## 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` · MCP tool: `bluesky-activity-subscriptions-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–100)
- `cursor` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/activity-subscriptions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "did": "string",
      "handle": "string",
      "display_name": "string",
      "description": "string",
      "avatar_url": "https://example.com",
      "banner_url": "https://example.com",
      "followers_count": 1,
      "following_count": 1,
      "posts_count": 1,
      "labels": [
        "string"
      ],
      "is_bot": true,
      "verified": true,
      "created_at": "2026-10-13T09:00:00.000Z",
      "indexed_at": "2026-10-13T09:00:00.000Z",
      "viewer_following": "string",
      "viewer_followed_by": "string",
      "viewer_muted": true,
      "viewer_blocking": "string",
      "viewer_blocked_by": true,
      "allow_incoming_chat": "all",
      "url": "https://example.com",
      "notify_posts": true,
      "notify_replies": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `bluesky-activity-subscriptions-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `actor` (string; required)
- `notify_posts` (boolean)
- `notify_replies` (boolean)

```bash
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:

```json
{
  "id": "string",
  "did": "string",
  "handle": "string",
  "display_name": "string",
  "description": "string",
  "avatar_url": "https://example.com",
  "banner_url": "https://example.com",
  "followers_count": 1,
  "following_count": 1,
  "posts_count": 1,
  "labels": [
    "string"
  ],
  "is_bot": true,
  "verified": true,
  "created_at": "2026-10-13T09:00:00.000Z",
  "indexed_at": "2026-10-13T09:00:00.000Z",
  "viewer_following": "string",
  "viewer_followed_by": "string",
  "viewer_muted": true,
  "viewer_blocking": "string",
  "viewer_blocked_by": true,
  "allow_incoming_chat": "all",
  "url": "https://example.com",
  "notify_posts": true,
  "notify_replies": true
}
```

## 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` · MCP tool: `bluesky-activity-subscriptions-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `notify_posts` (boolean)
- `notify_replies` (boolean)

```bash
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:

```json
{
  "id": "string",
  "did": "string",
  "handle": "string",
  "display_name": "string",
  "description": "string",
  "avatar_url": "https://example.com",
  "banner_url": "https://example.com",
  "followers_count": 1,
  "following_count": 1,
  "posts_count": 1,
  "labels": [
    "string"
  ],
  "is_bot": true,
  "verified": true,
  "created_at": "2026-10-13T09:00:00.000Z",
  "indexed_at": "2026-10-13T09:00:00.000Z",
  "viewer_following": "string",
  "viewer_followed_by": "string",
  "viewer_muted": true,
  "viewer_blocking": "string",
  "viewer_blocked_by": true,
  "allow_incoming_chat": "all",
  "url": "https://example.com",
  "notify_posts": true,
  "notify_replies": true
}
```

## 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` · MCP tool: `bluesky-activity-subscriptions-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/activity-subscriptions/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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` · MCP tool: `bluesky-chat-settings-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/chat-settings" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "allow_incoming": "all"
}
```

## 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` · MCP tool: `bluesky-chat-settings-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Body

- `allow_incoming` (string; required; one of all, following, none)

```bash
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:

```json
{
  "allow_incoming": "all"
}
```

## 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` · MCP tool: `bluesky-likes-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–100)
- `cursor` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/likes" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "uri": "string",
      "cid": "string",
      "rkey": "string",
      "url": "https://example.com",
      "text": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "indexed_at": "2026-10-13T09:00:00.000Z",
      "langs": [
        "string"
      ],
      "tags": [
        "string"
      ],
      "labels": [
        "string"
      ],
      "author_id": "string",
      "author_handle": "string",
      "author_name": "string",
      "author_avatar": "https://example.com",
      "is_own": true,
      "is_reply": true,
      "parent_id": "string",
      "root_id": "string",
      "like_count": 1,
      "repost_count": 1,
      "reply_count": 1,
      "quote_count": 1,
      "bookmark_count": 1,
      "embed": {
        "type": "images",
        "images": [
          {
            "url": null,
            "thumb": null,
            "alt": null
          }
        ],
        "playlist": "https://example.com",
        "thumbnail": "https://example.com",
        "uri": "https://example.com",
        "title": "string"
      },
      "viewer_like": "string",
      "viewer_repost": "string",
      "viewer_bookmarked": true,
      "viewer_thread_muted": true,
      "reply_disabled": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `bluesky-likes-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `uri` (string; required): post AT-URI or bsky.app URL

```bash
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:

```json
{
  "id": "string",
  "uri": "string",
  "cid": "string",
  "rkey": "string",
  "url": "https://example.com",
  "text": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "indexed_at": "2026-10-13T09:00:00.000Z",
  "langs": [
    "string"
  ],
  "tags": [
    "string"
  ],
  "labels": [
    "string"
  ],
  "author_id": "string",
  "author_handle": "string",
  "author_name": "string",
  "author_avatar": "https://example.com",
  "is_own": true,
  "is_reply": true,
  "parent_id": "string",
  "root_id": "string",
  "like_count": 1,
  "repost_count": 1,
  "reply_count": 1,
  "quote_count": 1,
  "bookmark_count": 1,
  "embed": {
    "type": "images",
    "images": [
      {
        "url": "https://example.com",
        "thumb": "https://example.com",
        "alt": "string"
      }
    ],
    "playlist": "https://example.com",
    "thumbnail": "https://example.com",
    "uri": "https://example.com",
    "title": "string",
    "record_uri": "string"
  },
  "viewer_like": "string",
  "viewer_repost": "string",
  "viewer_bookmarked": true,
  "viewer_thread_muted": true,
  "reply_disabled": true,
  "embedding_disabled": true,
  "pinned": true,
  "reposted_by": "string",
  "threadgate_rules": [
    "string"
  ],
  "hidden_replies": [
    "string"
  ]
}
```

## 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` · MCP tool: `bluesky-likes-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/likes/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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` · MCP tool: `bluesky-reposts-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–100)
- `cursor` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/reposts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "uri": "string",
      "cid": "string",
      "rkey": "string",
      "url": "https://example.com",
      "text": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "indexed_at": "2026-10-13T09:00:00.000Z",
      "langs": [
        "string"
      ],
      "tags": [
        "string"
      ],
      "labels": [
        "string"
      ],
      "author_id": "string",
      "author_handle": "string",
      "author_name": "string",
      "author_avatar": "https://example.com",
      "is_own": true,
      "is_reply": true,
      "parent_id": "string",
      "root_id": "string",
      "like_count": 1,
      "repost_count": 1,
      "reply_count": 1,
      "quote_count": 1,
      "bookmark_count": 1,
      "embed": {
        "type": "images",
        "images": [
          {
            "url": null,
            "thumb": null,
            "alt": null
          }
        ],
        "playlist": "https://example.com",
        "thumbnail": "https://example.com",
        "uri": "https://example.com",
        "title": "string"
      },
      "viewer_like": "string",
      "viewer_repost": "string",
      "viewer_bookmarked": true,
      "viewer_thread_muted": true,
      "reply_disabled": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `bluesky-reposts-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `uri` (string; required): post AT-URI or bsky.app URL

```bash
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:

```json
{
  "id": "string",
  "uri": "string",
  "cid": "string",
  "rkey": "string",
  "url": "https://example.com",
  "text": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "indexed_at": "2026-10-13T09:00:00.000Z",
  "langs": [
    "string"
  ],
  "tags": [
    "string"
  ],
  "labels": [
    "string"
  ],
  "author_id": "string",
  "author_handle": "string",
  "author_name": "string",
  "author_avatar": "https://example.com",
  "is_own": true,
  "is_reply": true,
  "parent_id": "string",
  "root_id": "string",
  "like_count": 1,
  "repost_count": 1,
  "reply_count": 1,
  "quote_count": 1,
  "bookmark_count": 1,
  "embed": {
    "type": "images",
    "images": [
      {
        "url": "https://example.com",
        "thumb": "https://example.com",
        "alt": "string"
      }
    ],
    "playlist": "https://example.com",
    "thumbnail": "https://example.com",
    "uri": "https://example.com",
    "title": "string",
    "record_uri": "string"
  },
  "viewer_like": "string",
  "viewer_repost": "string",
  "viewer_bookmarked": true,
  "viewer_thread_muted": true,
  "reply_disabled": true,
  "embedding_disabled": true,
  "pinned": true,
  "reposted_by": "string",
  "threadgate_rules": [
    "string"
  ],
  "hidden_replies": [
    "string"
  ],
  "repost_uri": "string",
  "reposted_at": "2026-10-13T09:00:00.000Z"
}
```

## 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` · MCP tool: `bluesky-reposts-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/reposts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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` · MCP tool: `bluesky-bookmarks-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–100)
- `cursor` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/bookmarks" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "uri": "string",
      "cid": "string",
      "rkey": "string",
      "url": "https://example.com",
      "text": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "indexed_at": "2026-10-13T09:00:00.000Z",
      "langs": [
        "string"
      ],
      "tags": [
        "string"
      ],
      "labels": [
        "string"
      ],
      "author_id": "string",
      "author_handle": "string",
      "author_name": "string",
      "author_avatar": "https://example.com",
      "is_own": true,
      "is_reply": true,
      "parent_id": "string",
      "root_id": "string",
      "like_count": 1,
      "repost_count": 1,
      "reply_count": 1,
      "quote_count": 1,
      "bookmark_count": 1,
      "embed": {
        "type": "images",
        "images": [
          {
            "url": null,
            "thumb": null,
            "alt": null
          }
        ],
        "playlist": "https://example.com",
        "thumbnail": "https://example.com",
        "uri": "https://example.com",
        "title": "string"
      },
      "viewer_like": "string",
      "viewer_repost": "string",
      "viewer_bookmarked": true,
      "viewer_thread_muted": true,
      "reply_disabled": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `bluesky-bookmarks-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `uri` (string; required): post AT-URI or bsky.app URL

```bash
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:

```json
{
  "id": "string",
  "uri": "string",
  "cid": "string",
  "rkey": "string",
  "url": "https://example.com",
  "text": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "indexed_at": "2026-10-13T09:00:00.000Z",
  "langs": [
    "string"
  ],
  "tags": [
    "string"
  ],
  "labels": [
    "string"
  ],
  "author_id": "string",
  "author_handle": "string",
  "author_name": "string",
  "author_avatar": "https://example.com",
  "is_own": true,
  "is_reply": true,
  "parent_id": "string",
  "root_id": "string",
  "like_count": 1,
  "repost_count": 1,
  "reply_count": 1,
  "quote_count": 1,
  "bookmark_count": 1,
  "embed": {
    "type": "images",
    "images": [
      {
        "url": "https://example.com",
        "thumb": "https://example.com",
        "alt": "string"
      }
    ],
    "playlist": "https://example.com",
    "thumbnail": "https://example.com",
    "uri": "https://example.com",
    "title": "string",
    "record_uri": "string"
  },
  "viewer_like": "string",
  "viewer_repost": "string",
  "viewer_bookmarked": true,
  "viewer_thread_muted": true,
  "reply_disabled": true,
  "embedding_disabled": true,
  "pinned": true,
  "reposted_by": "string",
  "threadgate_rules": [
    "string"
  ],
  "hidden_replies": [
    "string"
  ],
  "bookmarked_at": "2026-10-13T09:00:00.000Z"
}
```

## 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` · MCP tool: `bluesky-bookmarks-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/bookmarks/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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` · MCP tool: `bluesky-post-engagement-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `uri` (string; required)
- `type` (string; one of likes, reposts, quotes)
- `limit` (integer)
- `cursor` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/post-engagement?uri=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "did": "string",
      "handle": "string",
      "display_name": "string",
      "description": "string",
      "avatar_url": "https://example.com",
      "banner_url": "https://example.com",
      "followers_count": 1,
      "following_count": 1,
      "posts_count": 1,
      "labels": [
        "string"
      ],
      "is_bot": true,
      "verified": true,
      "created_at": "2026-10-13T09:00:00.000Z",
      "indexed_at": "2026-10-13T09:00:00.000Z",
      "viewer_following": "string",
      "viewer_followed_by": "string",
      "viewer_muted": true,
      "viewer_blocking": "string",
      "viewer_blocked_by": true,
      "allow_incoming_chat": "all",
      "url": "https://example.com",
      "engaged_at": "2026-10-13T09:00:00.000Z",
      "quote_uri": "string",
      "quote_text": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `bluesky-followers-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–100)
- `cursor` (string)
- `actor` (string): defaults to the account

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/followers" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "did": "string",
      "handle": "string",
      "display_name": "string",
      "description": "string",
      "avatar_url": "https://example.com",
      "banner_url": "https://example.com",
      "followers_count": 1,
      "following_count": 1,
      "posts_count": 1,
      "labels": [
        "string"
      ],
      "is_bot": true,
      "verified": true,
      "created_at": "2026-10-13T09:00:00.000Z",
      "indexed_at": "2026-10-13T09:00:00.000Z",
      "viewer_following": "string",
      "viewer_followed_by": "string",
      "viewer_muted": true,
      "viewer_blocking": "string",
      "viewer_blocked_by": true,
      "allow_incoming_chat": "all",
      "url": "https://example.com"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `bluesky-followers-follow`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `bluesky-followers-unfollow`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `bluesky-followers-mute`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `bluesky-followers-unmute`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `bluesky-followers-block`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `bluesky-followers-unblock`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `bluesky-followers-report`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `reason_type` (string; one of spam, violation, misleading, sexual, rude, other)
- `reason` (string)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `bluesky-following-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–100)
- `cursor` (string)
- `actor` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/following" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "did": "string",
      "handle": "string",
      "display_name": "string",
      "description": "string",
      "avatar_url": "https://example.com",
      "banner_url": "https://example.com",
      "followers_count": 1,
      "following_count": 1,
      "posts_count": 1,
      "labels": [
        "string"
      ],
      "is_bot": true,
      "verified": true,
      "created_at": "2026-10-13T09:00:00.000Z",
      "indexed_at": "2026-10-13T09:00:00.000Z",
      "viewer_following": "string",
      "viewer_followed_by": "string",
      "viewer_muted": true,
      "viewer_blocking": "string",
      "viewer_blocked_by": true,
      "allow_incoming_chat": "all",
      "url": "https://example.com"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `bluesky-following-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `actor` (string; required): handle or DID

```bash
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:

```json
{
  "id": "string",
  "did": "string",
  "handle": "string",
  "display_name": "string",
  "description": "string",
  "avatar_url": "https://example.com",
  "banner_url": "https://example.com",
  "followers_count": 1,
  "following_count": 1,
  "posts_count": 1,
  "labels": [
    "string"
  ],
  "is_bot": true,
  "verified": true,
  "created_at": "2026-10-13T09:00:00.000Z",
  "indexed_at": "2026-10-13T09:00:00.000Z",
  "viewer_following": "string",
  "viewer_followed_by": "string",
  "viewer_muted": true,
  "viewer_blocking": "string",
  "viewer_blocked_by": true,
  "allow_incoming_chat": "all",
  "url": "https://example.com"
}
```

## 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` · MCP tool: `bluesky-following-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/following/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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: `write` · MCP tool: `bluesky-following-mute`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `bluesky-following-block`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `bluesky-blocks-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–100)
- `cursor` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/blocks" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "did": "string",
      "handle": "string",
      "display_name": "string",
      "description": "string",
      "avatar_url": "https://example.com",
      "banner_url": "https://example.com",
      "followers_count": 1,
      "following_count": 1,
      "posts_count": 1,
      "labels": [
        "string"
      ],
      "is_bot": true,
      "verified": true,
      "created_at": "2026-10-13T09:00:00.000Z",
      "indexed_at": "2026-10-13T09:00:00.000Z",
      "viewer_following": "string",
      "viewer_followed_by": "string",
      "viewer_muted": true,
      "viewer_blocking": "string",
      "viewer_blocked_by": true,
      "allow_incoming_chat": "all",
      "url": "https://example.com"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `bluesky-blocks-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `actor` (string; required): handle or DID

```bash
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:

```json
{
  "id": "string",
  "did": "string",
  "handle": "string",
  "display_name": "string",
  "description": "string",
  "avatar_url": "https://example.com",
  "banner_url": "https://example.com",
  "followers_count": 1,
  "following_count": 1,
  "posts_count": 1,
  "labels": [
    "string"
  ],
  "is_bot": true,
  "verified": true,
  "created_at": "2026-10-13T09:00:00.000Z",
  "indexed_at": "2026-10-13T09:00:00.000Z",
  "viewer_following": "string",
  "viewer_followed_by": "string",
  "viewer_muted": true,
  "viewer_blocking": "string",
  "viewer_blocked_by": true,
  "allow_incoming_chat": "all",
  "url": "https://example.com"
}
```

## 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` · MCP tool: `bluesky-blocks-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/blocks/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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` · MCP tool: `bluesky-mutes-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–100)
- `cursor` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/mutes" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "did": "string",
      "handle": "string",
      "display_name": "string",
      "description": "string",
      "avatar_url": "https://example.com",
      "banner_url": "https://example.com",
      "followers_count": 1,
      "following_count": 1,
      "posts_count": 1,
      "labels": [
        "string"
      ],
      "is_bot": true,
      "verified": true,
      "created_at": "2026-10-13T09:00:00.000Z",
      "indexed_at": "2026-10-13T09:00:00.000Z",
      "viewer_following": "string",
      "viewer_followed_by": "string",
      "viewer_muted": true,
      "viewer_blocking": "string",
      "viewer_blocked_by": true,
      "allow_incoming_chat": "all",
      "url": "https://example.com"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `bluesky-mutes-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `actor` (string; required): handle or DID

```bash
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:

```json
{
  "id": "string",
  "did": "string",
  "handle": "string",
  "display_name": "string",
  "description": "string",
  "avatar_url": "https://example.com",
  "banner_url": "https://example.com",
  "followers_count": 1,
  "following_count": 1,
  "posts_count": 1,
  "labels": [
    "string"
  ],
  "is_bot": true,
  "verified": true,
  "created_at": "2026-10-13T09:00:00.000Z",
  "indexed_at": "2026-10-13T09:00:00.000Z",
  "viewer_following": "string",
  "viewer_followed_by": "string",
  "viewer_muted": true,
  "viewer_blocking": "string",
  "viewer_blocked_by": true,
  "allow_incoming_chat": "all",
  "url": "https://example.com"
}
```

## 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` · MCP tool: `bluesky-mutes-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/mutes/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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` · MCP tool: `bluesky-suggested-follows-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–100)
- `cursor` (string)
- `similar_to` (string): handle/DID: accounts similar to this one

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/suggested-follows" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "did": "string",
      "handle": "string",
      "display_name": "string",
      "description": "string",
      "avatar_url": "https://example.com",
      "banner_url": "https://example.com",
      "followers_count": 1,
      "following_count": 1,
      "posts_count": 1,
      "labels": [
        "string"
      ],
      "is_bot": true,
      "verified": true,
      "created_at": "2026-10-13T09:00:00.000Z",
      "indexed_at": "2026-10-13T09:00:00.000Z",
      "viewer_following": "string",
      "viewer_followed_by": "string",
      "viewer_muted": true,
      "viewer_blocking": "string",
      "viewer_blocked_by": true,
      "allow_incoming_chat": "all",
      "url": "https://example.com"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `bluesky-suggested-follows-follow`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `bluesky-suggested-follows-mute`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `bluesky-lists-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–100)
- `cursor` (string)
- `purpose` (string; one of curate, mod, reference)
- `actor` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/lists" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "uri": "string",
      "cid": "string",
      "name": "string",
      "purpose": "curate",
      "description": "string",
      "avatar_url": "https://example.com",
      "member_count": 1,
      "creator_handle": "string",
      "viewer_muted": true,
      "viewer_blocked": "string",
      "labels": [
        "string"
      ],
      "indexed_at": "2026-10-13T09:00:00.000Z",
      "url": "https://example.com"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `bluesky-lists-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `name` (string; required)
- `purpose` (string; required; one of curate, mod)
- `description` (string)
- `avatar` (string)

```bash
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:

```json
{
  "id": "string",
  "uri": "string",
  "cid": "string",
  "name": "string",
  "purpose": "curate",
  "description": "string",
  "avatar_url": "https://example.com",
  "member_count": 1,
  "creator_handle": "string",
  "viewer_muted": true,
  "viewer_blocked": "string",
  "labels": [
    "string"
  ],
  "indexed_at": "2026-10-13T09:00:00.000Z",
  "url": "https://example.com"
}
```

## 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` · MCP tool: `bluesky-lists-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/lists/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "uri": "string",
  "cid": "string",
  "name": "string",
  "purpose": "curate",
  "description": "string",
  "avatar_url": "https://example.com",
  "member_count": 1,
  "creator_handle": "string",
  "viewer_muted": true,
  "viewer_blocked": "string",
  "labels": [
    "string"
  ],
  "indexed_at": "2026-10-13T09:00:00.000Z",
  "url": "https://example.com"
}
```

## 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` · MCP tool: `bluesky-lists-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `name` (string)
- `description` (string | null)
- `avatar` (string)
- `remove_avatar` (boolean)

```bash
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:

```json
{
  "id": "string",
  "uri": "string",
  "cid": "string",
  "name": "string",
  "purpose": "curate",
  "description": "string",
  "avatar_url": "https://example.com",
  "member_count": 1,
  "creator_handle": "string",
  "viewer_muted": true,
  "viewer_blocked": "string",
  "labels": [
    "string"
  ],
  "indexed_at": "2026-10-13T09:00:00.000Z",
  "url": "https://example.com"
}
```

## 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` · MCP tool: `bluesky-lists-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/lists/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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: `write` · MCP tool: `bluesky-lists-mute-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `bluesky-lists-unmute-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `bluesky-lists-block-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `bluesky-lists-unblock-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `bluesky-list-members-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–100)
- `cursor` (string)
- `list` (string): list AT-URI or URL

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/list-members" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "did": "string",
      "handle": "string",
      "display_name": "string",
      "description": "string",
      "avatar_url": "https://example.com",
      "banner_url": "https://example.com",
      "followers_count": 1,
      "following_count": 1,
      "posts_count": 1,
      "labels": [
        "string"
      ],
      "is_bot": true,
      "verified": true,
      "created_at": "2026-10-13T09:00:00.000Z",
      "indexed_at": "2026-10-13T09:00:00.000Z",
      "viewer_following": "string",
      "viewer_followed_by": "string",
      "viewer_muted": true,
      "viewer_blocking": "string",
      "viewer_blocked_by": true,
      "allow_incoming_chat": "all",
      "url": "https://example.com",
      "listitem_uri": "string",
      "list_uri": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `bluesky-list-members-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `list` (string; required)
- `actor` (string; required): handle or DID

```bash
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:

```json
{
  "id": "string",
  "did": "string",
  "handle": "string",
  "display_name": "string",
  "description": "string",
  "avatar_url": "https://example.com",
  "banner_url": "https://example.com",
  "followers_count": 1,
  "following_count": 1,
  "posts_count": 1,
  "labels": [
    "string"
  ],
  "is_bot": true,
  "verified": true,
  "created_at": "2026-10-13T09:00:00.000Z",
  "indexed_at": "2026-10-13T09:00:00.000Z",
  "viewer_following": "string",
  "viewer_followed_by": "string",
  "viewer_muted": true,
  "viewer_blocking": "string",
  "viewer_blocked_by": true,
  "allow_incoming_chat": "all",
  "url": "https://example.com",
  "listitem_uri": "string",
  "list_uri": "string"
}
```

## 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` · MCP tool: `bluesky-list-members-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/list-members/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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` · MCP tool: `bluesky-starter-packs-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–100)
- `cursor` (string)
- `actor` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/starter-packs" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "uri": "string",
      "cid": "string",
      "name": "string",
      "description": "string",
      "list_uri": "string",
      "feeds": [
        "string"
      ],
      "member_count": 1,
      "joined_week": 1,
      "joined_all_time": 1,
      "creator_handle": "string",
      "members_sample": [
        "string"
      ],
      "created_at": "2026-10-13T09:00:00.000Z",
      "url": "https://example.com"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `bluesky-starter-packs-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `name` (string; required)
- `description` (string)
- `members` (array of string; ≤ 150 items)
- `feeds` (array of string; ≤ 3 items)

```bash
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:

```json
{
  "id": "string",
  "uri": "string",
  "cid": "string",
  "name": "string",
  "description": "string",
  "list_uri": "string",
  "feeds": [
    "string"
  ],
  "member_count": 1,
  "joined_week": 1,
  "joined_all_time": 1,
  "creator_handle": "string",
  "members_sample": [
    "string"
  ],
  "created_at": "2026-10-13T09:00:00.000Z",
  "url": "https://example.com"
}
```

## 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` · MCP tool: `bluesky-starter-packs-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/starter-packs/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "uri": "string",
  "cid": "string",
  "name": "string",
  "description": "string",
  "list_uri": "string",
  "feeds": [
    "string"
  ],
  "member_count": 1,
  "joined_week": 1,
  "joined_all_time": 1,
  "creator_handle": "string",
  "members_sample": [
    "string"
  ],
  "created_at": "2026-10-13T09:00:00.000Z",
  "url": "https://example.com"
}
```

## 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` · MCP tool: `bluesky-starter-packs-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `name` (string)
- `description` (string | null)
- `feeds` (array of string; ≤ 3 items)

```bash
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:

```json
{
  "id": "string",
  "uri": "string",
  "cid": "string",
  "name": "string",
  "description": "string",
  "list_uri": "string",
  "feeds": [
    "string"
  ],
  "member_count": 1,
  "joined_week": 1,
  "joined_all_time": 1,
  "creator_handle": "string",
  "members_sample": [
    "string"
  ],
  "created_at": "2026-10-13T09:00:00.000Z",
  "url": "https://example.com"
}
```

## 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` · MCP tool: `bluesky-starter-packs-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/starter-packs/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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: `write` · MCP tool: `bluesky-starter-packs-add-member`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `actor` (string; required)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `bluesky-starter-packs-remove-member`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `actor` (string; required)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `bluesky-list-subscriptions-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–100)
- `cursor` (string)
- `type` (string; one of mute, block)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/list-subscriptions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "uri": "string",
      "cid": "string",
      "name": "string",
      "purpose": "curate",
      "description": "string",
      "avatar_url": "https://example.com",
      "member_count": 1,
      "creator_handle": "string",
      "viewer_muted": true,
      "viewer_blocked": "string",
      "labels": [
        "string"
      ],
      "indexed_at": "2026-10-13T09:00:00.000Z",
      "url": "https://example.com",
      "subscription": "mute"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `bluesky-list-subscriptions-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/list-subscriptions/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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` · MCP tool: `bluesky-saved-feeds-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/saved-feeds" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "type": "feed",
      "value": "string",
      "pinned": true,
      "position": 1,
      "display_name": "string",
      "description": "string",
      "avatar_url": "https://example.com",
      "creator_handle": "string",
      "url": "https://example.com"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `bluesky-saved-feeds-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `uri` (string; required): feed generator or list AT-URI / URL
- `pinned` (boolean)

```bash
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:

```json
{
  "id": "string",
  "type": "feed",
  "value": "string",
  "pinned": true,
  "position": 1,
  "display_name": "string",
  "description": "string",
  "avatar_url": "https://example.com",
  "creator_handle": "string",
  "url": "https://example.com"
}
```

## 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` · MCP tool: `bluesky-saved-feeds-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `pinned` (boolean; required)

```bash
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:

```json
{
  "id": "string",
  "type": "feed",
  "value": "string",
  "pinned": true,
  "position": 1,
  "display_name": "string",
  "description": "string",
  "avatar_url": "https://example.com",
  "creator_handle": "string",
  "url": "https://example.com"
}
```

## 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` · MCP tool: `bluesky-saved-feeds-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/saved-feeds/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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: `write` · MCP tool: `bluesky-saved-feeds-reorder`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `ids` (array of string; required)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `bluesky-feed-generators-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–100)
- `cursor` (string)
- `q` (string): search (app.bsky.unspecced.getPopularFeedGenerators)
- `actor` (string): feeds created by this account

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/feed-generators" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "uri": "string",
      "cid": "string",
      "service_did": "string",
      "display_name": "string",
      "description": "string",
      "avatar_url": "https://example.com",
      "like_count": 1,
      "creator_handle": "string",
      "accepts_interactions": true,
      "content_mode": "contentModeUnspecified",
      "viewer_like": "string",
      "labels": [
        "string"
      ],
      "url": "https://example.com"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `bluesky-feed-generators-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/feed-generators/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "uri": "string",
  "cid": "string",
  "service_did": "string",
  "display_name": "string",
  "description": "string",
  "avatar_url": "https://example.com",
  "like_count": 1,
  "creator_handle": "string",
  "accepts_interactions": true,
  "content_mode": "contentModeUnspecified",
  "viewer_like": "string",
  "labels": [
    "string"
  ],
  "url": "https://example.com"
}
```

## 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: `write` · MCP tool: `bluesky-feed-generators-save`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `bluesky-feed-generators-pin`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `bluesky-feed-generators-like`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `bluesky-feed-generators-unlike`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `bluesky-feed-posts-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–100)
- `cursor` (string)
- `feed` (string): feed generator or list AT-URI / URL

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/feed-posts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "uri": "string",
      "cid": "string",
      "rkey": "string",
      "url": "https://example.com",
      "text": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "indexed_at": "2026-10-13T09:00:00.000Z",
      "langs": [
        "string"
      ],
      "tags": [
        "string"
      ],
      "labels": [
        "string"
      ],
      "author_id": "string",
      "author_handle": "string",
      "author_name": "string",
      "author_avatar": "https://example.com",
      "is_own": true,
      "is_reply": true,
      "parent_id": "string",
      "root_id": "string",
      "like_count": 1,
      "repost_count": 1,
      "reply_count": 1,
      "quote_count": 1,
      "bookmark_count": 1,
      "embed": {
        "type": "images",
        "images": [
          {
            "url": null,
            "thumb": null,
            "alt": null
          }
        ],
        "playlist": "https://example.com",
        "thumbnail": "https://example.com",
        "uri": "https://example.com",
        "title": "string"
      },
      "viewer_like": "string",
      "viewer_repost": "string",
      "viewer_bookmarked": true,
      "viewer_thread_muted": true,
      "reply_disabled": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `bluesky-my-feeds-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–100)
- `cursor` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/my-feeds" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "uri": "string",
      "cid": "string",
      "service_did": "string",
      "display_name": "string",
      "description": "string",
      "avatar_url": "https://example.com",
      "like_count": 1,
      "creator_handle": "string",
      "accepts_interactions": true,
      "content_mode": "contentModeUnspecified",
      "viewer_like": "string",
      "labels": [
        "string"
      ],
      "url": "https://example.com"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `bluesky-my-feeds-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `rkey` (string; required; pattern ^[a-zA-Z0-9-]{1,15}$): short feed id used in the URL (create only)
- `service_did` (string; required): did:web of the feed generator service
- `display_name` (string; required): ≤ 24 graphemes
- `description` (string)
- `avatar` (string)
- `accepts_interactions` (boolean)
- `content_mode` (string; one of unspecified, video)

```bash
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:

```json
{
  "id": "string",
  "uri": "string",
  "cid": "string",
  "service_did": "string",
  "display_name": "string",
  "description": "string",
  "avatar_url": "https://example.com",
  "like_count": 1,
  "creator_handle": "string",
  "accepts_interactions": true,
  "content_mode": "contentModeUnspecified",
  "viewer_like": "string",
  "labels": [
    "string"
  ],
  "url": "https://example.com"
}
```

## 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` · MCP tool: `bluesky-my-feeds-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `rkey` (string; pattern ^[a-zA-Z0-9-]{1,15}$): short feed id used in the URL (create only)
- `service_did` (string): did:web of the feed generator service
- `display_name` (string): ≤ 24 graphemes
- `description` (string)
- `avatar` (string)
- `accepts_interactions` (boolean)
- `content_mode` (string; one of unspecified, video)

```bash
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:

```json
{
  "id": "string",
  "uri": "string",
  "cid": "string",
  "service_did": "string",
  "display_name": "string",
  "description": "string",
  "avatar_url": "https://example.com",
  "like_count": 1,
  "creator_handle": "string",
  "accepts_interactions": true,
  "content_mode": "contentModeUnspecified",
  "viewer_like": "string",
  "labels": [
    "string"
  ],
  "url": "https://example.com"
}
```

## 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` · MCP tool: `bluesky-my-feeds-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/my-feeds/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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: `write` · MCP tool: `bluesky-reports-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `subject` (string; required): post/list/feed AT-URI or URL, or an account handle/DID
- `reason_type` (string; required; one of spam, violation, misleading, sexual, rude, other, appeal)
- `reason` (string; ≤ 2000 characters)
- `labeler` (string): labeler DID (default Bluesky moderation)

```bash
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:

```json
{
  "id": 1,
  "reason_type": "string",
  "subject": {
    "uri": "string",
    "did": "string"
  },
  "created_at": "2026-10-13T09:00:00.000Z"
}
```

## 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` · MCP tool: `bluesky-muted-words-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/muted-words" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "value": "string",
      "targets": [
        "content"
      ],
      "actor_target": "all",
      "expires_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `bluesky-muted-words-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `value` (string; required)
- `targets` (array of string)
- `actor_target` (string; one of all, exclude-following)
- `expires_at` (string (date-time) | null)

```bash
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:

```json
{
  "id": "string",
  "value": "string",
  "targets": [
    "content"
  ],
  "actor_target": "all",
  "expires_at": "2026-10-13T09:00:00.000Z"
}
```

## 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` · MCP tool: `bluesky-muted-words-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `value` (string)
- `targets` (array of string)
- `actor_target` (string; one of all, exclude-following)
- `expires_at` (string (date-time) | null)

```bash
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:

```json
{
  "id": "string",
  "value": "string",
  "targets": [
    "content"
  ],
  "actor_target": "all",
  "expires_at": "2026-10-13T09:00:00.000Z"
}
```

## 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` · MCP tool: `bluesky-muted-words-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/muted-words/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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` · MCP tool: `bluesky-content-filters-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/content-filters" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "adult_content_enabled": true,
  "labels": {
    "porn": "ignore",
    "sexual": "ignore",
    "nudity": "ignore",
    "graphic-media": "ignore",
    "gore": "ignore"
  }
}
```

## 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` · MCP tool: `bluesky-content-filters-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Body

- `adult_content_enabled` (boolean)
- `labels` (object)
  - `labels.porn` (string; one of ignore, show, warn, hide)
  - `labels.sexual` (string; one of ignore, show, warn, hide)
  - `labels.nudity` (string; one of ignore, show, warn, hide)
  - `labels.graphic-media` (string; one of ignore, show, warn, hide)
  - `labels.gore` (string; one of ignore, show, warn, hide)

```bash
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:

```json
{
  "adult_content_enabled": true,
  "labels": {
    "porn": "ignore",
    "sexual": "ignore",
    "nudity": "ignore",
    "graphic-media": "ignore",
    "gore": "ignore"
  }
}
```

## 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` · MCP tool: `bluesky-labelers-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/labelers" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "did": "string",
      "handle": "string",
      "display_name": "string",
      "description": "string",
      "avatar_url": "https://example.com",
      "like_count": 1,
      "label_values": [
        "string"
      ],
      "builtin": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `bluesky-labelers-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `did` (string; required): labeler account DID

```bash
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:

```json
{
  "id": "string",
  "did": "string",
  "handle": "string",
  "display_name": "string",
  "description": "string",
  "avatar_url": "https://example.com",
  "like_count": 1,
  "label_values": [
    "string"
  ],
  "builtin": true
}
```

## 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` · MCP tool: `bluesky-labelers-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/labelers/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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` · MCP tool: `bluesky-hidden-posts-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/hidden-posts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "uri": "string",
      "cid": "string",
      "rkey": "string",
      "url": "https://example.com",
      "text": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "indexed_at": "2026-10-13T09:00:00.000Z",
      "langs": [
        "string"
      ],
      "tags": [
        "string"
      ],
      "labels": [
        "string"
      ],
      "author_id": "string",
      "author_handle": "string",
      "author_name": "string",
      "author_avatar": "https://example.com",
      "is_own": true,
      "is_reply": true,
      "parent_id": "string",
      "root_id": "string",
      "like_count": 1,
      "repost_count": 1,
      "reply_count": 1,
      "quote_count": 1,
      "bookmark_count": 1,
      "embed": {
        "type": "images",
        "images": [
          {
            "url": null,
            "thumb": null,
            "alt": null
          }
        ],
        "playlist": "https://example.com",
        "thumbnail": "https://example.com",
        "uri": "https://example.com",
        "title": "string"
      },
      "viewer_like": "string",
      "viewer_repost": "string",
      "viewer_bookmarked": true,
      "viewer_thread_muted": true,
      "reply_disabled": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `bluesky-hidden-posts-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `uri` (string; required)

```bash
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:

```json
{
  "id": "string",
  "uri": "string",
  "cid": "string",
  "rkey": "string",
  "url": "https://example.com",
  "text": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "indexed_at": "2026-10-13T09:00:00.000Z",
  "langs": [
    "string"
  ],
  "tags": [
    "string"
  ],
  "labels": [
    "string"
  ],
  "author_id": "string",
  "author_handle": "string",
  "author_name": "string",
  "author_avatar": "https://example.com",
  "is_own": true,
  "is_reply": true,
  "parent_id": "string",
  "root_id": "string",
  "like_count": 1,
  "repost_count": 1,
  "reply_count": 1,
  "quote_count": 1,
  "bookmark_count": 1,
  "embed": {
    "type": "images",
    "images": [
      {
        "url": "https://example.com",
        "thumb": "https://example.com",
        "alt": "string"
      }
    ],
    "playlist": "https://example.com",
    "thumbnail": "https://example.com",
    "uri": "https://example.com",
    "title": "string",
    "record_uri": "string"
  },
  "viewer_like": "string",
  "viewer_repost": "string",
  "viewer_bookmarked": true,
  "viewer_thread_muted": true,
  "reply_disabled": true,
  "embedding_disabled": true,
  "pinned": true,
  "reposted_by": "string",
  "threadgate_rules": [
    "string"
  ],
  "hidden_replies": [
    "string"
  ]
}
```

## 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` · MCP tool: `bluesky-hidden-posts-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/hidden-posts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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` · MCP tool: `bluesky-search-posts-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `q` (string; required)
- `sort` (string; one of top, latest)
- `since` (string (date-time))
- `until` (string (date-time))
- `author` (string)
- `mentions` (string)
- `lang` (string)
- `domain` (string)
- `url` (string (uri))
- `tag` (array of string)
- `limit` (integer; ≤ 100)
- `cursor` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/search-posts?q=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "uri": "string",
      "cid": "string",
      "rkey": "string",
      "url": "https://example.com",
      "text": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "indexed_at": "2026-10-13T09:00:00.000Z",
      "langs": [
        "string"
      ],
      "tags": [
        "string"
      ],
      "labels": [
        "string"
      ],
      "author_id": "string",
      "author_handle": "string",
      "author_name": "string",
      "author_avatar": "https://example.com",
      "is_own": true,
      "is_reply": true,
      "parent_id": "string",
      "root_id": "string",
      "like_count": 1,
      "repost_count": 1,
      "reply_count": 1,
      "quote_count": 1,
      "bookmark_count": 1,
      "embed": {
        "type": "images",
        "images": [
          {
            "url": null,
            "thumb": null,
            "alt": null
          }
        ],
        "playlist": "https://example.com",
        "thumbnail": "https://example.com",
        "uri": "https://example.com",
        "title": "string"
      },
      "viewer_like": "string",
      "viewer_repost": "string",
      "viewer_bookmarked": true,
      "viewer_thread_muted": true,
      "reply_disabled": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `bluesky-search-posts-like`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `bluesky-search-posts-repost`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `bluesky-search-accounts-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `q` (string; required)
- `typeahead` (boolean)
- `limit` (integer)
- `cursor` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/search-accounts?q=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "did": "string",
      "handle": "string",
      "display_name": "string",
      "description": "string",
      "avatar_url": "https://example.com",
      "banner_url": "https://example.com",
      "followers_count": 1,
      "following_count": 1,
      "posts_count": 1,
      "labels": [
        "string"
      ],
      "is_bot": true,
      "verified": true,
      "created_at": "2026-10-13T09:00:00.000Z",
      "indexed_at": "2026-10-13T09:00:00.000Z",
      "viewer_following": "string",
      "viewer_followed_by": "string",
      "viewer_muted": true,
      "viewer_blocking": "string",
      "viewer_blocked_by": true,
      "allow_incoming_chat": "all",
      "url": "https://example.com"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `bluesky-search-accounts-follow`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `bluesky-search-accounts-mute`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `bluesky-search-starter-packs-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `q` (string; required)
- `limit` (integer)
- `cursor` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/search-starter-packs?q=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "uri": "string",
      "name": "string",
      "description": "string",
      "member_count": 1,
      "joined_all_time": 1,
      "creator_handle": "string",
      "url": "https://example.com"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `bluesky-analytics-overview-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/analytics-overview" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "followers": 1,
  "following": 1,
  "posts_count": 1,
  "series": [
    {
      "date": "2026-10-13",
      "metrics": {
        "followers": 1,
        "following": 1,
        "follower_change": 1
      }
    }
  ],
  "totals": {
    "followers": 1,
    "following": 1,
    "follower_change": 1
  },
  "recent_engagement": {
    "posts": 1,
    "likes": 1,
    "shares": 1,
    "comments": 1,
    "quotes": 1,
    "saves": 1,
    "engagements": 1
  }
}
```

## 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` · MCP tool: `bluesky-post-analytics-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `sort` (string; one of recent, top)
- `limit` (integer; ≤ 200)
- `since` (string (date-time))
- `until` (string (date-time))

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/post-analytics" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "text": "string",
      "like_count": 1,
      "repost_count": 1,
      "reply_count": 1,
      "quote_count": 1,
      "bookmark_count": 1,
      "engagements": 1,
      "url": "https://example.com"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `bluesky-video-limits-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/bluesky/video-limits" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "can_upload": true,
  "remaining_daily_videos": 1,
  "remaining_daily_bytes": 1,
  "message": "string"
}
```


---

Source: https://socialit.com/docs/api-reference/focus-bluesky/
