# Focus · X API

> Typed Focus mode operations for X accounts, generated from the X 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>`.

## X: List Bookmarks

`GET /accounts/{accountId}/x/bookmarks`

GET /2/users/:id/bookmarks (or a folder). Your bookmarks, optionally inside a folder: a curation library for reposts and inspiration. Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read, users.read, bookmark.read. Generic route: /v1/accounts/{accountId}/focus/bookmarks.

Access: `read` · MCP tool: `x-bookmarks-list`

### Path parameters

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

### Query parameters

- `cursor` (string): Pagination cursor (next_cursor)
- `limit` (integer; 1–100)
- `folder_id` (string)

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "text": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "url": "https://example.com",
      "kind": "post",
      "author_id": "string",
      "author_username": "string",
      "author_name": "string",
      "author_avatar_url": "https://example.com",
      "conversation_id": "string",
      "in_reply_to_user_id": "string",
      "reply_to_id": "string",
      "quoted_id": "string",
      "reposted_id": "string",
      "lang": "string",
      "reply_settings": "everyone",
      "community_id": "string",
      "possibly_sensitive": true,
      "paid_partnership": true,
      "editable_until": "2026-10-13T09:00:00.000Z",
      "edits_remaining": 1,
      "media": [
        {
          "media_key": "string",
          "type": "photo",
          "url": "https://example.com",
          "preview_image_url": "https://example.com",
          "width": 1,
          "height": 1
        }
      ],
      "poll": {
        "id": "string",
        "options": [
          {
            "position": null,
            "label": null,
            "votes": null
          }
        ],
        "total_votes": 1,
        "voting_status": "open",
        "end_datetime": "2026-10-13T09:00:00.000Z",
        "duration_minutes": 1
      },
      "likes": 1,
      "reposts": 1,
      "replies": 1,
      "quotes": 1,
      "bookmarks": 1,
      "impressions": 1
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## X: List Following

`GET /accounts/{accountId}/x/following`

GET /2/users/:id/following. Accounts you follow. Follow/unfollow are Enterprise-only on X since 2026-04-20. Cursor pagination: pass next_cursor back as cursor. Requires scopes: follows.read, users.read, tweet.read. Generic route: /v1/accounts/{accountId}/focus/following.

Access: `read` · MCP tool: `x-following-list`

### Path parameters

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

### Query parameters

- `cursor` (string): Pagination cursor (next_cursor)
- `limit` (integer; 1–1000)
- `user_id` (string)

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "username": "string",
      "name": "string",
      "url": "https://example.com",
      "avatar_url": "https://example.com",
      "description": "string",
      "location": "string",
      "website": "https://example.com",
      "created_at": "2026-10-13T09:00:00.000Z",
      "protected": true,
      "verified": true,
      "verified_type": "blue",
      "followers": 1,
      "following": 1,
      "posts": 1,
      "listed": 1,
      "likes": 1,
      "media_count": 1
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## X: List Posts

`GET /accounts/{accountId}/x/posts`

Your timeline (GET /2/users/:id/tweets). Your posts: publish, edit (X Premium, 30 min), delete, repost, bookmark and reply. Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read, users.read. Network docs: https://docs.x.com/x-api/posts/create-post Generic route: /v1/accounts/{accountId}/focus/posts.

Access: `read` · MCP tool: `x-posts-list` · Zernio: `GET /v1/accounts/{accountId}/posts`, `GET /v1/twitter/tweet`

### Path parameters

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

### Query parameters

- `cursor` (string): Pagination cursor (next_cursor)
- `limit` (integer; 1–100)
- `exclude` (string; one of replies, retweets, replies,retweets)
- `start_time` (string (date-time))
- `end_time` (string (date-time))
- `since_id` (string)
- `until_id` (string)

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "text": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "url": "https://example.com",
      "kind": "post",
      "author_id": "string",
      "author_username": "string",
      "author_name": "string",
      "author_avatar_url": "https://example.com",
      "conversation_id": "string",
      "in_reply_to_user_id": "string",
      "reply_to_id": "string",
      "quoted_id": "string",
      "reposted_id": "string",
      "lang": "string",
      "reply_settings": "everyone",
      "community_id": "string",
      "possibly_sensitive": true,
      "paid_partnership": true,
      "editable_until": "2026-10-13T09:00:00.000Z",
      "edits_remaining": 1,
      "media": [
        {
          "media_key": "string",
          "type": "photo",
          "url": "https://example.com",
          "preview_image_url": "https://example.com",
          "width": 1,
          "height": 1
        }
      ],
      "poll": {
        "id": "string",
        "options": [
          {
            "position": null,
            "label": null,
            "votes": null
          }
        ],
        "total_votes": 1,
        "voting_status": "open",
        "end_datetime": "2026-10-13T09:00:00.000Z",
        "duration_minutes": 1
      },
      "likes": 1,
      "reposts": 1,
      "replies": 1,
      "quotes": 1,
      "bookmarks": 1,
      "impressions": 1
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## X: Create a Posts item

`POST /accounts/{accountId}/x/posts`

Publish a post (POST /2/tweets). Your posts: publish, edit (X Premium, 30 min), delete, repost, bookmark and reply. Requires scopes: tweet.read, users.read, tweet.write. Network docs: https://docs.x.com/x-api/posts/create-post Generic route: /v1/accounts/{accountId}/focus/posts.

Access: `write` · MCP tool: `x-posts-create` · Zernio: `POST /v1/posts`, `POST /v1/posts/{postId}/edit`, `POST /v1/posts/{postId}/unpublish`, `POST /v1/twitter/retweet`, `POST /v1/twitter/bookmark`, `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; required)
- `media` (array of string | object; ≤ 4 items): Up to 4 images, or 1 GIF, or 1 video
  - one of: Option 1 (string)
  - one of: Option 2 (object)
    - `media.media` (string)
    - `media.alt_text` (string; ≤ 1000 characters)
- `reply_settings` (string; one of following, mentionedUsers, subscribers, verified)
- `reply_to_post_id` (string): Reply to this post (id or URL)
- `quote_post_id` (string): Quote this post (Enterprise-only)
- `community_id` (string)
- `for_super_followers_only` (boolean)
- `paid_partnership` (boolean)
- `made_with_ai` (boolean)
- `sensitive_media` (object)
  - `sensitive_media.adult_content` (boolean)
  - `sensitive_media.graphic_violence` (boolean)
  - `sensitive_media.other` (boolean)
- `geo_countries` (array of string; ≤ 25 items)
- `place_id` (string)
- `tagged_user_ids` (array of string; ≤ 10 items)
- `long_video` (boolean)
- `first_comment` (string)
- `auto_thread` (boolean): Split long text into a thread

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/posts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string",
    "media": [
      "string"
    ],
    "reply_settings": "following",
    "reply_to_post_id": "string",
    "quote_post_id": "string"
  }'
```

Response 201:

```json
{
  "id": "string",
  "text": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "url": "https://example.com",
  "kind": "post",
  "author_id": "string",
  "author_username": "string",
  "author_name": "string",
  "author_avatar_url": "https://example.com",
  "conversation_id": "string",
  "in_reply_to_user_id": "string",
  "reply_to_id": "string",
  "quoted_id": "string",
  "reposted_id": "string",
  "lang": "string",
  "reply_settings": "everyone",
  "community_id": "string",
  "possibly_sensitive": true,
  "paid_partnership": true,
  "editable_until": "2026-10-13T09:00:00.000Z",
  "edits_remaining": 1,
  "media": [
    {
      "media_key": "string",
      "type": "photo",
      "url": "https://example.com",
      "preview_image_url": "https://example.com",
      "width": 1,
      "height": 1,
      "duration_ms": 1,
      "alt_text": "string",
      "view_count": 1
    }
  ],
  "poll": {
    "id": "string",
    "options": [
      {
        "position": 1,
        "label": "string",
        "votes": 1
      }
    ],
    "total_votes": 1,
    "voting_status": "open",
    "end_datetime": "2026-10-13T09:00:00.000Z",
    "duration_minutes": 1
  },
  "likes": 1,
  "reposts": 1,
  "replies": 1,
  "quotes": 1,
  "bookmarks": 1,
  "impressions": 1
}
```

## X: Get a Posts item

`GET /accounts/{accountId}/x/posts/{itemId}`

Post lookup (GET /2/tweets/:id). Your posts: publish, edit (X Premium, 30 min), delete, repost, bookmark and reply. Requires scopes: tweet.read, users.read. Network docs: https://docs.x.com/x-api/posts/create-post Generic route: /v1/accounts/{accountId}/focus/posts.

Access: `read` · MCP tool: `x-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/x/posts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "text": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "url": "https://example.com",
  "kind": "post",
  "author_id": "string",
  "author_username": "string",
  "author_name": "string",
  "author_avatar_url": "https://example.com",
  "conversation_id": "string",
  "in_reply_to_user_id": "string",
  "reply_to_id": "string",
  "quoted_id": "string",
  "reposted_id": "string",
  "lang": "string",
  "reply_settings": "everyone",
  "community_id": "string",
  "possibly_sensitive": true,
  "paid_partnership": true,
  "editable_until": "2026-10-13T09:00:00.000Z",
  "edits_remaining": 1,
  "media": [
    {
      "media_key": "string",
      "type": "photo",
      "url": "https://example.com",
      "preview_image_url": "https://example.com",
      "width": 1,
      "height": 1,
      "duration_ms": 1,
      "alt_text": "string",
      "view_count": 1
    }
  ],
  "poll": {
    "id": "string",
    "options": [
      {
        "position": 1,
        "label": "string",
        "votes": 1
      }
    ],
    "total_votes": 1,
    "voting_status": "open",
    "end_datetime": "2026-10-13T09:00:00.000Z",
    "duration_minutes": 1
  },
  "likes": 1,
  "reposts": 1,
  "replies": 1,
  "quotes": 1,
  "bookmarks": 1,
  "impressions": 1
}
```

## X: Update a Posts item

`PATCH /accounts/{accountId}/x/posts/{itemId}`

Edit a post (X Premium; returns a new post id). Your posts: publish, edit (X Premium, 30 min), delete, repost, bookmark and reply. Requires scopes: tweet.read, users.read, tweet.write. Network docs: https://docs.x.com/x-api/posts/create-post Generic route: /v1/accounts/{accountId}/focus/posts.

Access: `write` · MCP tool: `x-posts-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

- `text` (string; required)
- `media` (array of string; ≤ 4 items)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/posts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string",
    "media": [
      "string"
    ]
  }'
```

Response 200:

```json
{
  "id": "string",
  "text": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "url": "https://example.com",
  "kind": "post",
  "author_id": "string",
  "author_username": "string",
  "author_name": "string",
  "author_avatar_url": "https://example.com",
  "conversation_id": "string",
  "in_reply_to_user_id": "string",
  "reply_to_id": "string",
  "quoted_id": "string",
  "reposted_id": "string",
  "lang": "string",
  "reply_settings": "everyone",
  "community_id": "string",
  "possibly_sensitive": true,
  "paid_partnership": true,
  "editable_until": "2026-10-13T09:00:00.000Z",
  "edits_remaining": 1,
  "media": [
    {
      "media_key": "string",
      "type": "photo",
      "url": "https://example.com",
      "preview_image_url": "https://example.com",
      "width": 1,
      "height": 1,
      "duration_ms": 1,
      "alt_text": "string",
      "view_count": 1
    }
  ],
  "poll": {
    "id": "string",
    "options": [
      {
        "position": 1,
        "label": "string",
        "votes": 1
      }
    ],
    "total_votes": 1,
    "voting_status": "open",
    "end_datetime": "2026-10-13T09:00:00.000Z",
    "duration_minutes": 1
  },
  "likes": 1,
  "reposts": 1,
  "replies": 1,
  "quotes": 1,
  "bookmarks": 1,
  "impressions": 1
}
```

## X: Delete a Posts item

`DELETE /accounts/{accountId}/x/posts/{itemId}`

Delete a post (DELETE /2/tweets/:id). Your posts: publish, edit (X Premium, 30 min), delete, repost, bookmark and reply. Requires scopes: tweet.read, users.read, tweet.write. Network docs: https://docs.x.com/x-api/posts/create-post Generic route: /v1/accounts/{accountId}/focus/posts.

Access: `write` · MCP tool: `x-posts-delete` · Zernio: `DELETE /v1/twitter/retweet`, `DELETE /v1/twitter/bookmark`, `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/x/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
}
```

## X: Reply (Posts)

`POST /accounts/{accountId}/x/posts/{itemId}/reply`

Reply. Your posts: publish, edit (X Premium, 30 min), delete, repost, bookmark and reply. Requires scopes: tweet.read, users.read, tweet.write. Network docs: https://docs.x.com/x-api/posts/create-post Generic route: /v1/accounts/{accountId}/focus/posts.

Access: `write` · MCP tool: `x-posts-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; ≤ 25000 characters)
- `media` (array of string; ≤ 4 items)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/posts/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string",
    "media": [
      "string"
    ]
  }'
```

Response 200:

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

## X: Repost (Posts)

`POST /accounts/{accountId}/x/posts/{itemId}/repost`

Repost. Your posts: publish, edit (X Premium, 30 min), delete, repost, bookmark and reply. Requires scopes: tweet.read, users.read, tweet.write. Network docs: https://docs.x.com/x-api/posts/create-post Generic route: /v1/accounts/{accountId}/focus/posts.

Access: `write` · MCP tool: `x-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/x/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
}
```

## X: Undo repost (Posts)

`POST /accounts/{accountId}/x/posts/{itemId}/undo-repost`

Undo repost. Your posts: publish, edit (X Premium, 30 min), delete, repost, bookmark and reply. Requires scopes: tweet.read, users.read, tweet.write. Network docs: https://docs.x.com/x-api/posts/create-post Generic route: /v1/accounts/{accountId}/focus/posts.

Access: `write` · MCP tool: `x-posts-undo-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/x/posts/ITEM_ID/undo-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
}
```

## X: Like (Posts)

`POST /accounts/{accountId}/x/posts/{itemId}/like`

Enterprise-only on X. Your posts: publish, edit (X Premium, 30 min), delete, repost, bookmark and reply. Requires scopes: tweet.read, users.read, like.write. Network docs: https://docs.x.com/x-api/posts/create-post Generic route: /v1/accounts/{accountId}/focus/posts.

Access: `write` · MCP tool: `x-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/x/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
}
```

## X: Unlike (Posts)

`POST /accounts/{accountId}/x/posts/{itemId}/unlike`

Enterprise-only on X. Your posts: publish, edit (X Premium, 30 min), delete, repost, bookmark and reply. Requires scopes: tweet.read, users.read, like.write. Network docs: https://docs.x.com/x-api/posts/create-post Generic route: /v1/accounts/{accountId}/focus/posts.

Access: `write` · MCP tool: `x-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/x/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
}
```

## X: Bookmark (Posts)

`POST /accounts/{accountId}/x/posts/{itemId}/bookmark`

Bookmark. Your posts: publish, edit (X Premium, 30 min), delete, repost, bookmark and reply. Requires scopes: tweet.read, users.read, bookmark.write. Network docs: https://docs.x.com/x-api/posts/create-post Generic route: /v1/accounts/{accountId}/focus/posts.

Access: `write` · MCP tool: `x-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.

### Body

- `folder_id` (string)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/posts/ITEM_ID/bookmark" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "folder_id": "string"
  }'
```

Response 200:

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

## X: Remove bookmark (Posts)

`POST /accounts/{accountId}/x/posts/{itemId}/remove-bookmark`

Remove bookmark. Your posts: publish, edit (X Premium, 30 min), delete, repost, bookmark and reply. Requires scopes: tweet.read, users.read, bookmark.write. Network docs: https://docs.x.com/x-api/posts/create-post Generic route: /v1/accounts/{accountId}/focus/posts.

Access: `write` · MCP tool: `x-posts-remove-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/x/posts/ITEM_ID/remove-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
}
```

## X: Get a Threads item

`GET /accounts/{accountId}/x/threads/{itemId}`

Your posts in the conversation rooted at :id (recent search). Publish multi-post threads and read back your own threads. Requires scopes: tweet.read, users.read. Generic route: /v1/accounts/{accountId}/focus/threads.

Access: `read` · MCP tool: `x-threads-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/x/threads/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "url": "https://example.com",
  "items": [
    {
      "id": "string",
      "text": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "url": "https://example.com",
      "kind": "post",
      "author_id": "string",
      "author_username": "string",
      "author_name": "string",
      "author_avatar_url": "https://example.com",
      "conversation_id": "string",
      "in_reply_to_user_id": "string",
      "reply_to_id": "string",
      "quoted_id": "string",
      "reposted_id": "string",
      "lang": "string",
      "reply_settings": "everyone",
      "community_id": "string",
      "possibly_sensitive": true,
      "paid_partnership": true,
      "editable_until": "2026-10-13T09:00:00.000Z",
      "edits_remaining": 1,
      "media": [
        {
          "media_key": "string",
          "type": "photo",
          "url": "https://example.com",
          "preview_image_url": "https://example.com",
          "width": 1,
          "height": 1
        }
      ],
      "poll": {
        "id": "string",
        "options": [
          {
            "position": null,
            "label": null,
            "votes": null
          }
        ],
        "total_votes": 1,
        "voting_status": "open",
        "end_datetime": "2026-10-13T09:00:00.000Z",
        "duration_minutes": 1
      },
      "likes": 1,
      "reposts": 1,
      "replies": 1,
      "quotes": 1,
      "bookmarks": 1,
      "impressions": 1
    }
  ],
  "thread_ids": [
    "string"
  ]
}
```

## X: Create a Threads item

`POST /accounts/{accountId}/x/threads`

Publish a thread (chained POST /2/tweets). Publish multi-post threads and read back your own threads. Requires scopes: tweet.read, users.read, tweet.write. Generic route: /v1/accounts/{accountId}/focus/threads.

Access: `write` · MCP tool: `x-threads-create` · Zernio: `POST /v1/posts`

### 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

- `items` (array of object; required; ≥ 1 items)
  - `items[].text` (string; required)
  - `items[].media` (array of string; ≤ 4 items)
- `reply_settings` (string; one of following, mentionedUsers, subscribers, verified)
- `first_comment` (string)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/threads" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {
        "text": "string",
        "media": [
          "string"
        ]
      }
    ],
    "reply_settings": "following",
    "first_comment": "string"
  }'
```

Response 201:

```json
{
  "id": "string",
  "url": "https://example.com",
  "items": [
    {
      "id": "string",
      "text": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "url": "https://example.com",
      "kind": "post",
      "author_id": "string",
      "author_username": "string",
      "author_name": "string",
      "author_avatar_url": "https://example.com",
      "conversation_id": "string",
      "in_reply_to_user_id": "string",
      "reply_to_id": "string",
      "quoted_id": "string",
      "reposted_id": "string",
      "lang": "string",
      "reply_settings": "everyone",
      "community_id": "string",
      "possibly_sensitive": true,
      "paid_partnership": true,
      "editable_until": "2026-10-13T09:00:00.000Z",
      "edits_remaining": 1,
      "media": [
        {
          "media_key": "string",
          "type": "photo",
          "url": "https://example.com",
          "preview_image_url": "https://example.com",
          "width": 1,
          "height": 1
        }
      ],
      "poll": {
        "id": "string",
        "options": [
          {
            "position": null,
            "label": null,
            "votes": null
          }
        ],
        "total_votes": 1,
        "voting_status": "open",
        "end_datetime": "2026-10-13T09:00:00.000Z",
        "duration_minutes": 1
      },
      "likes": 1,
      "reposts": 1,
      "replies": 1,
      "quotes": 1,
      "bookmarks": 1,
      "impressions": 1
    }
  ],
  "thread_ids": [
    "string"
  ]
}
```

## X: List Polls

`GET /accounts/{accountId}/x/polls`

Your recent posts that carry a poll. Create polls (2-4 options, 5 min to 7 days) and follow their results. Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read, users.read. Generic route: /v1/accounts/{accountId}/focus/polls.

Access: `read` · MCP tool: `x-polls-list`

### Path parameters

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

### Query parameters

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

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "text": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "url": "https://example.com",
      "kind": "post",
      "author_id": "string",
      "author_username": "string",
      "author_name": "string",
      "author_avatar_url": "https://example.com",
      "conversation_id": "string",
      "in_reply_to_user_id": "string",
      "reply_to_id": "string",
      "quoted_id": "string",
      "reposted_id": "string",
      "lang": "string",
      "reply_settings": "everyone",
      "community_id": "string",
      "possibly_sensitive": true,
      "paid_partnership": true,
      "editable_until": "2026-10-13T09:00:00.000Z",
      "edits_remaining": 1,
      "media": [
        {
          "media_key": "string",
          "type": "photo",
          "url": "https://example.com",
          "preview_image_url": "https://example.com",
          "width": 1,
          "height": 1
        }
      ],
      "poll": {
        "id": "string",
        "options": [
          {
            "position": null,
            "label": null,
            "votes": null
          }
        ],
        "total_votes": 1,
        "voting_status": "open",
        "end_datetime": "2026-10-13T09:00:00.000Z",
        "duration_minutes": 1
      },
      "likes": 1,
      "reposts": 1,
      "replies": 1,
      "quotes": 1,
      "bookmarks": 1,
      "impressions": 1
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## X: Create a Polls item

`POST /accounts/{accountId}/x/polls`

Publish a poll. Create polls (2-4 options, 5 min to 7 days) and follow their results. Requires scopes: tweet.read, users.read, tweet.write. Generic route: /v1/accounts/{accountId}/focus/polls.

Access: `write` · MCP tool: `x-polls-create` · Zernio: `POST /v1/posts`

### 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; required)
- `options` (array of string; required; 2–4 items)
- `duration_minutes` (integer; required; 5–10080)
- `reply_settings` (string; one of following, mentionedUsers, subscribers, verified)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/polls" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string",
    "options": [
      "string"
    ],
    "duration_minutes": 1440,
    "reply_settings": "following"
  }'
```

Response 201:

```json
{
  "id": "string",
  "text": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "url": "https://example.com",
  "kind": "post",
  "author_id": "string",
  "author_username": "string",
  "author_name": "string",
  "author_avatar_url": "https://example.com",
  "conversation_id": "string",
  "in_reply_to_user_id": "string",
  "reply_to_id": "string",
  "quoted_id": "string",
  "reposted_id": "string",
  "lang": "string",
  "reply_settings": "everyone",
  "community_id": "string",
  "possibly_sensitive": true,
  "paid_partnership": true,
  "editable_until": "2026-10-13T09:00:00.000Z",
  "edits_remaining": 1,
  "media": [
    {
      "media_key": "string",
      "type": "photo",
      "url": "https://example.com",
      "preview_image_url": "https://example.com",
      "width": 1,
      "height": 1,
      "duration_ms": 1,
      "alt_text": "string",
      "view_count": 1
    }
  ],
  "poll": {
    "id": "string",
    "options": [
      {
        "position": 1,
        "label": "string",
        "votes": 1
      }
    ],
    "total_votes": 1,
    "voting_status": "open",
    "end_datetime": "2026-10-13T09:00:00.000Z",
    "duration_minutes": 1
  },
  "likes": 1,
  "reposts": 1,
  "replies": 1,
  "quotes": 1,
  "bookmarks": 1,
  "impressions": 1
}
```

## X: Get a Polls item

`GET /accounts/{accountId}/x/polls/{itemId}`

Poll results for a post. Create polls (2-4 options, 5 min to 7 days) and follow their results. Requires scopes: tweet.read, users.read. Generic route: /v1/accounts/{accountId}/focus/polls.

Access: `read` · MCP tool: `x-polls-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/x/polls/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "text": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "url": "https://example.com",
  "kind": "post",
  "author_id": "string",
  "author_username": "string",
  "author_name": "string",
  "author_avatar_url": "https://example.com",
  "conversation_id": "string",
  "in_reply_to_user_id": "string",
  "reply_to_id": "string",
  "quoted_id": "string",
  "reposted_id": "string",
  "lang": "string",
  "reply_settings": "everyone",
  "community_id": "string",
  "possibly_sensitive": true,
  "paid_partnership": true,
  "editable_until": "2026-10-13T09:00:00.000Z",
  "edits_remaining": 1,
  "media": [
    {
      "media_key": "string",
      "type": "photo",
      "url": "https://example.com",
      "preview_image_url": "https://example.com",
      "width": 1,
      "height": 1,
      "duration_ms": 1,
      "alt_text": "string",
      "view_count": 1
    }
  ],
  "poll": {
    "id": "string",
    "options": [
      {
        "position": 1,
        "label": "string",
        "votes": 1
      }
    ],
    "total_votes": 1,
    "voting_status": "open",
    "end_datetime": "2026-10-13T09:00:00.000Z",
    "duration_minutes": 1
  },
  "likes": 1,
  "reposts": 1,
  "replies": 1,
  "quotes": 1,
  "bookmarks": 1,
  "impressions": 1
}
```

## X: Create a Articles item

`POST /accounts/{accountId}/x/articles`

Create an Article draft and optionally publish it. Long-form X Articles: save a draft on X or publish (the account must be eligible for Articles). Requires scopes: tweet.write. Network docs: https://docs.x.com/x-api/articles/introduction Generic route: /v1/accounts/{accountId}/focus/articles.

Access: `write` · MCP tool: `x-articles-create` · Zernio: `POST /v1/posts`

### 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

- `title` (string; required; ≥ 1 characters)
- `text` (string): Body; "# ", "## ", "> ", "- ", "1. " prefixes become headings, quotes and lists
- `content_state` (object): DraftJS content_state (snake_case); overrides text
  - `content_state.blocks` (array of object)
  - `content_state.entities` (array of object)
- `mode` (string; one of publish, draft)
- `cover` (string): Cover image (JPG, PNG or WebP)
- `cover_alt_text` (string; ≤ 1000 characters)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/articles" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "string",
    "text": "string",
    "content_state": {
      "blocks": [
        {}
      ],
      "entities": [
        {}
      ]
    },
    "mode": "publish",
    "cover": "string"
  }'
```

Response 201:

```json
{
  "id": "string",
  "article_id": "string",
  "title": "string",
  "mode": "publish",
  "url": "https://example.com"
}
```

## X: Publish draft (Articles)

`POST /accounts/{accountId}/x/articles/{itemId}/publish`

POST /2/articles/:id/publish. Long-form X Articles: save a draft on X or publish (the account must be eligible for Articles). Requires scopes: tweet.write. Network docs: https://docs.x.com/x-api/articles/introduction Generic route: /v1/accounts/{accountId}/focus/articles.

Access: `write` · MCP tool: `x-articles-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.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/articles/ITEM_ID/publish" \
  -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
}
```

## X: List Media

`GET /accounts/{accountId}/x/media`

Look up media by key (GET /2/media). Upload images, GIFs and video to X, set alt text and sensitive flags, manage subtitles. Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read. Network docs: https://docs.x.com/x-api/media/introduction Generic route: /v1/accounts/{accountId}/focus/media.

Access: `read` · MCP tool: `x-media-list`

### Path parameters

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

### Query parameters

- `media_keys` (string; required): Comma-separated media keys

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "media_key": "string",
      "media_id": "string",
      "type": "string",
      "url": "https://example.com",
      "preview_image_url": "https://example.com",
      "width": 1,
      "height": 1,
      "duration_ms": 1,
      "alt_text": "string",
      "view_count": 1
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## X: Create a Media item

`POST /accounts/{accountId}/x/media`

Upload media (simple for images, chunked for GIF/video). Upload images, GIFs and video to X, set alt text and sensitive flags, manage subtitles. Requires scopes: tweet.read, media.write. Network docs: https://docs.x.com/x-api/media/introduction Generic route: /v1/accounts/{accountId}/focus/media.

Access: `write` · MCP tool: `x-media-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

- `media` (string; required)
- `category` (string; one of tweet_image, tweet_gif, tweet_video, amplify_video, dm_image, dm_gif, dm_video)
- `alt_text` (string; ≤ 1000 characters)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/media" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "media": "string",
    "category": "tweet_image",
    "alt_text": "string"
  }'
```

Response 201:

```json
{
  "media_key": "string",
  "media_id": "string",
  "type": "string",
  "url": "https://example.com",
  "preview_image_url": "https://example.com",
  "width": 1,
  "height": 1,
  "duration_ms": 1,
  "alt_text": "string",
  "view_count": 1
}
```

## X: Get a Media item

`GET /accounts/{accountId}/x/media/{itemId}`

GET /2/media/:media_key. Upload images, GIFs and video to X, set alt text and sensitive flags, manage subtitles. Requires scopes: tweet.read. Network docs: https://docs.x.com/x-api/media/introduction Generic route: /v1/accounts/{accountId}/focus/media.

Access: `read` · MCP tool: `x-media-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/x/media/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "media_key": "string",
  "media_id": "string",
  "type": "string",
  "url": "https://example.com",
  "preview_image_url": "https://example.com",
  "width": 1,
  "height": 1,
  "duration_ms": 1,
  "alt_text": "string",
  "view_count": 1
}
```

## X: Alt text and flags (Media)

`POST /accounts/{accountId}/x/media/{itemId}/set-metadata`

Alt text and flags. Upload images, GIFs and video to X, set alt text and sensitive flags, manage subtitles. Requires scopes: tweet.read, media.write. Network docs: https://docs.x.com/x-api/media/introduction Generic route: /v1/accounts/{accountId}/focus/media.

Access: `write` · MCP tool: `x-media-set-metadata`

### 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

- `alt_text` (string; ≤ 1000 characters)
- `sensitive_media` (object)
  - `sensitive_media.adult_content` (boolean)
  - `sensitive_media.graphic_violence` (boolean)
  - `sensitive_media.other` (boolean)
- `geo_countries` (array of string)
- `allow_download` (boolean)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/media/ITEM_ID/set-metadata" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "alt_text": "string",
    "sensitive_media": {
      "adult_content": true,
      "graphic_violence": true
    },
    "geo_countries": [
      "string"
    ],
    "allow_download": true
  }'
```

Response 200:

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

## X: Add subtitles (Media)

`POST /accounts/{accountId}/x/media/{itemId}/add-subtitles`

Add subtitles. Upload images, GIFs and video to X, set alt text and sensitive flags, manage subtitles. Requires scopes: tweet.read, media.write. Network docs: https://docs.x.com/x-api/media/introduction Generic route: /v1/accounts/{accountId}/focus/media.

Access: `write` · MCP tool: `x-media-add-subtitles`

### 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

- `file` (string; required): SRT or VTT file
- `language` (string; required; ≥ 2 characters)
- `display_name` (string)
- `amplify` (boolean)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/media/ITEM_ID/add-subtitles" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "file": "string",
    "language": "en",
    "display_name": "string",
    "amplify": true
  }'
```

Response 200:

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

## X: Delete subtitles (Media)

`POST /accounts/{accountId}/x/media/{itemId}/delete-subtitles`

Delete subtitles. Upload images, GIFs and video to X, set alt text and sensitive flags, manage subtitles. Destructive. Requires scopes: tweet.read, media.write. Network docs: https://docs.x.com/x-api/media/introduction Generic route: /v1/accounts/{accountId}/focus/media.

Access: `write` · MCP tool: `x-media-delete-subtitles`

### 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

- `language` (string; required; ≥ 2 characters)
- `amplify` (boolean)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/media/ITEM_ID/delete-subtitles" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "language": "en",
    "amplify": true
  }'
```

Response 200:

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

## X: Processing status (Media)

`POST /accounts/{accountId}/x/media/{itemId}/status`

Processing status. Upload images, GIFs and video to X, set alt text and sensitive flags, manage subtitles. Requires scopes: tweet.read, media.write. Network docs: https://docs.x.com/x-api/media/introduction Generic route: /v1/accounts/{accountId}/focus/media.

Access: `write` · MCP tool: `x-media-status`

### 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/x/media/ITEM_ID/status" \
  -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
}
```

## X: List Replies

`GET /accounts/{accountId}/x/replies`

Replies to one post (post_id) or to all your recent posts. Replies to your posts (last 7 days): reply, hide/unhide, like, delete your own. Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read, users.read. Generic route: /v1/accounts/{accountId}/focus/replies.

Access: `read` · MCP tool: `x-replies-list` · Zernio: `GET /v1/inbox/comments`, `GET /v1/inbox/comments/{postId}`

### Path parameters

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

### Query parameters

- `cursor` (string): Pagination cursor (next_cursor)
- `limit` (integer; 1–100)
- `post_id` (string): Root post id or URL
- `archive` (boolean): Full-archive search (older than 7 days)

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "text": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "url": "https://example.com",
      "kind": "post",
      "author_id": "string",
      "author_username": "string",
      "author_name": "string",
      "author_avatar_url": "https://example.com",
      "conversation_id": "string",
      "in_reply_to_user_id": "string",
      "reply_to_id": "string",
      "quoted_id": "string",
      "reposted_id": "string",
      "lang": "string",
      "reply_settings": "everyone",
      "community_id": "string",
      "possibly_sensitive": true,
      "paid_partnership": true,
      "editable_until": "2026-10-13T09:00:00.000Z",
      "edits_remaining": 1,
      "media": [
        {
          "media_key": "string",
          "type": "photo",
          "url": "https://example.com",
          "preview_image_url": "https://example.com",
          "width": 1,
          "height": 1
        }
      ],
      "poll": {
        "id": "string",
        "options": [
          {
            "position": null,
            "label": null,
            "votes": null
          }
        ],
        "total_votes": 1,
        "voting_status": "open",
        "end_datetime": "2026-10-13T09:00:00.000Z",
        "duration_minutes": 1
      },
      "likes": 1,
      "reposts": 1,
      "replies": 1,
      "quotes": 1,
      "bookmarks": 1,
      "impressions": 1,
      "author": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## X: Create a Replies item

`POST /accounts/{accountId}/x/replies`

Reply to a post or reply. Replies to your posts (last 7 days): reply, hide/unhide, like, delete your own. Requires scopes: tweet.read, users.read, tweet.write. Generic route: /v1/accounts/{accountId}/focus/replies.

Access: `write` · MCP tool: `x-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

- `reply_to_id` (string; required)
- `text` (string; required)
- `media` (array of string; ≤ 4 items)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/replies" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "reply_to_id": "string",
    "text": "string",
    "media": [
      "string"
    ]
  }'
```

Response 201:

```json
{
  "id": "string",
  "text": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "url": "https://example.com",
  "kind": "post",
  "author_id": "string",
  "author_username": "string",
  "author_name": "string",
  "author_avatar_url": "https://example.com",
  "conversation_id": "string",
  "in_reply_to_user_id": "string",
  "reply_to_id": "string",
  "quoted_id": "string",
  "reposted_id": "string",
  "lang": "string",
  "reply_settings": "everyone",
  "community_id": "string",
  "possibly_sensitive": true,
  "paid_partnership": true,
  "editable_until": "2026-10-13T09:00:00.000Z",
  "edits_remaining": 1,
  "media": [
    {
      "media_key": "string",
      "type": "photo",
      "url": "https://example.com",
      "preview_image_url": "https://example.com",
      "width": 1,
      "height": 1,
      "duration_ms": 1,
      "alt_text": "string",
      "view_count": 1
    }
  ],
  "poll": {
    "id": "string",
    "options": [
      {
        "position": 1,
        "label": "string",
        "votes": 1
      }
    ],
    "total_votes": 1,
    "voting_status": "open",
    "end_datetime": "2026-10-13T09:00:00.000Z",
    "duration_minutes": 1
  },
  "likes": 1,
  "reposts": 1,
  "replies": 1,
  "quotes": 1,
  "bookmarks": 1,
  "impressions": 1,
  "author": "string",
  "parent_id": "string",
  "hidden": true
}
```

## X: Delete a Replies item

`DELETE /accounts/{accountId}/x/replies/{itemId}`

Delete one of your replies. Replies to your posts (last 7 days): reply, hide/unhide, like, delete your own. Requires scopes: tweet.read, users.read, tweet.write. Generic route: /v1/accounts/{accountId}/focus/replies.

Access: `write` · MCP tool: `x-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/x/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
}
```

## X: Reply (Replies)

`POST /accounts/{accountId}/x/replies/{itemId}/reply`

Reply. Replies to your posts (last 7 days): reply, hide/unhide, like, delete your own. Requires scopes: tweet.read, users.read, tweet.write. Generic route: /v1/accounts/{accountId}/focus/replies.

Access: `write` · MCP tool: `x-replies-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)
- `media` (array of string; ≤ 4 items)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/replies/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string",
    "media": [
      "string"
    ]
  }'
```

Response 200:

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

## X: Like (Replies)

`POST /accounts/{accountId}/x/replies/{itemId}/like`

Enterprise-only on X. Replies to your posts (last 7 days): reply, hide/unhide, like, delete your own. Requires scopes: tweet.read, users.read, like.write. Generic route: /v1/accounts/{accountId}/focus/replies.

Access: `write` · MCP tool: `x-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/x/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
}
```

## X: Unlike (Replies)

`POST /accounts/{accountId}/x/replies/{itemId}/unlike`

Enterprise-only on X. Replies to your posts (last 7 days): reply, hide/unhide, like, delete your own. Requires scopes: tweet.read, users.read, like.write. Generic route: /v1/accounts/{accountId}/focus/replies.

Access: `write` · MCP tool: `x-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/x/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
}
```

## X: Repost (Replies)

`POST /accounts/{accountId}/x/replies/{itemId}/repost`

Repost. Replies to your posts (last 7 days): reply, hide/unhide, like, delete your own. Requires scopes: tweet.read, users.read, tweet.write. Generic route: /v1/accounts/{accountId}/focus/replies.

Access: `write` · MCP tool: `x-replies-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/x/replies/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
}
```

## X: Bookmark (Replies)

`POST /accounts/{accountId}/x/replies/{itemId}/bookmark`

Bookmark. Replies to your posts (last 7 days): reply, hide/unhide, like, delete your own. Requires scopes: tweet.read, users.read, bookmark.write. Generic route: /v1/accounts/{accountId}/focus/replies.

Access: `write` · MCP tool: `x-replies-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/x/replies/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
}
```

## X: Hide reply (Replies)

`POST /accounts/{accountId}/x/replies/{itemId}/hide`

Hide reply. Replies to your posts (last 7 days): reply, hide/unhide, like, delete your own. Requires scopes: tweet.read, users.read, tweet.moderate.write. Generic route: /v1/accounts/{accountId}/focus/replies.

Access: `write` · MCP tool: `x-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/x/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
}
```

## X: Unhide reply (Replies)

`POST /accounts/{accountId}/x/replies/{itemId}/unhide`

Unhide reply. Replies to your posts (last 7 days): reply, hide/unhide, like, delete your own. Requires scopes: tweet.read, users.read, tweet.moderate.write. Generic route: /v1/accounts/{accountId}/focus/replies.

Access: `write` · MCP tool: `x-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/x/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
}
```

## X: List Mentions

`GET /accounts/{accountId}/x/mentions`

GET /2/users/:id/mentions. Posts that mention you. Replying is allowed on self-serve because you were summoned. Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read, users.read. Generic route: /v1/accounts/{accountId}/focus/mentions.

Access: `read` · MCP tool: `x-mentions-list` · Zernio: `GET /v1/inbox/mentions`

### Path parameters

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

### Query parameters

- `cursor` (string): Pagination cursor (next_cursor)
- `limit` (integer; 1–100)
- `since_id` (string)
- `start_time` (string (date-time))
- `end_time` (string (date-time))

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "text": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "url": "https://example.com",
      "kind": "post",
      "author_id": "string",
      "author_username": "string",
      "author_name": "string",
      "author_avatar_url": "https://example.com",
      "conversation_id": "string",
      "in_reply_to_user_id": "string",
      "reply_to_id": "string",
      "quoted_id": "string",
      "reposted_id": "string",
      "lang": "string",
      "reply_settings": "everyone",
      "community_id": "string",
      "possibly_sensitive": true,
      "paid_partnership": true,
      "editable_until": "2026-10-13T09:00:00.000Z",
      "edits_remaining": 1,
      "media": [
        {
          "media_key": "string",
          "type": "photo",
          "url": "https://example.com",
          "preview_image_url": "https://example.com",
          "width": 1,
          "height": 1
        }
      ],
      "poll": {
        "id": "string",
        "options": [
          {
            "position": null,
            "label": null,
            "votes": null
          }
        ],
        "total_votes": 1,
        "voting_status": "open",
        "end_datetime": "2026-10-13T09:00:00.000Z",
        "duration_minutes": 1
      },
      "likes": 1,
      "reposts": 1,
      "replies": 1,
      "quotes": 1,
      "bookmarks": 1,
      "impressions": 1,
      "author": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## X: Reply (Mentions)

`POST /accounts/{accountId}/x/mentions/{itemId}/reply`

Reply. Posts that mention you. Replying is allowed on self-serve because you were summoned. Requires scopes: tweet.read, users.read, tweet.write. Generic route: /v1/accounts/{accountId}/focus/mentions.

Access: `write` · MCP tool: `x-mentions-reply` · Zernio: `POST /v1/inbox/mentions/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)
- `media` (array of string; ≤ 4 items)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/mentions/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string",
    "media": [
      "string"
    ]
  }'
```

Response 200:

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

## X: Like (Mentions)

`POST /accounts/{accountId}/x/mentions/{itemId}/like`

Enterprise-only on X. Posts that mention you. Replying is allowed on self-serve because you were summoned. Requires scopes: tweet.read, users.read, like.write. Generic route: /v1/accounts/{accountId}/focus/mentions.

Access: `write` · MCP tool: `x-mentions-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/x/mentions/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
}
```

## X: Unlike (Mentions)

`POST /accounts/{accountId}/x/mentions/{itemId}/unlike`

Enterprise-only on X. Posts that mention you. Replying is allowed on self-serve because you were summoned. Requires scopes: tweet.read, users.read, like.write. Generic route: /v1/accounts/{accountId}/focus/mentions.

Access: `write` · MCP tool: `x-mentions-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/x/mentions/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
}
```

## X: Repost (Mentions)

`POST /accounts/{accountId}/x/mentions/{itemId}/repost`

Repost. Posts that mention you. Replying is allowed on self-serve because you were summoned. Requires scopes: tweet.read, users.read, tweet.write. Generic route: /v1/accounts/{accountId}/focus/mentions.

Access: `write` · MCP tool: `x-mentions-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/x/mentions/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
}
```

## X: Bookmark (Mentions)

`POST /accounts/{accountId}/x/mentions/{itemId}/bookmark`

Bookmark. Posts that mention you. Replying is allowed on self-serve because you were summoned. Requires scopes: tweet.read, users.read, bookmark.write. Generic route: /v1/accounts/{accountId}/focus/mentions.

Access: `write` · MCP tool: `x-mentions-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/x/mentions/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
}
```

## X: Hide reply (Mentions)

`POST /accounts/{accountId}/x/mentions/{itemId}/hide`

Only for replies in your conversations. Posts that mention you. Replying is allowed on self-serve because you were summoned. Requires scopes: tweet.read, users.read, tweet.moderate.write. Generic route: /v1/accounts/{accountId}/focus/mentions.

Access: `write` · MCP tool: `x-mentions-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/x/mentions/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
}
```

## X: List Quotes

`GET /accounts/{accountId}/x/quotes`

GET /2/tweets/:id/quote_tweets. Quote posts of one of your posts. Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read, users.read. Generic route: /v1/accounts/{accountId}/focus/quotes.

Access: `read` · MCP tool: `x-quotes-list`

### Path parameters

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

### Query parameters

- `cursor` (string): Pagination cursor (next_cursor)
- `limit` (integer; 1–100)
- `post_id` (string; required)

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "text": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "url": "https://example.com",
      "kind": "post",
      "author_id": "string",
      "author_username": "string",
      "author_name": "string",
      "author_avatar_url": "https://example.com",
      "conversation_id": "string",
      "in_reply_to_user_id": "string",
      "reply_to_id": "string",
      "quoted_id": "string",
      "reposted_id": "string",
      "lang": "string",
      "reply_settings": "everyone",
      "community_id": "string",
      "possibly_sensitive": true,
      "paid_partnership": true,
      "editable_until": "2026-10-13T09:00:00.000Z",
      "edits_remaining": 1,
      "media": [
        {
          "media_key": "string",
          "type": "photo",
          "url": "https://example.com",
          "preview_image_url": "https://example.com",
          "width": 1,
          "height": 1
        }
      ],
      "poll": {
        "id": "string",
        "options": [
          {
            "position": null,
            "label": null,
            "votes": null
          }
        ],
        "total_votes": 1,
        "voting_status": "open",
        "end_datetime": "2026-10-13T09:00:00.000Z",
        "duration_minutes": 1
      },
      "likes": 1,
      "reposts": 1,
      "replies": 1,
      "quotes": 1,
      "bookmarks": 1,
      "impressions": 1
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## X: Reply (Quotes)

`POST /accounts/{accountId}/x/quotes/{itemId}/reply`

Reply. Quote posts of one of your posts. Requires scopes: tweet.read, users.read, tweet.write. Generic route: /v1/accounts/{accountId}/focus/quotes.

Access: `write` · MCP tool: `x-quotes-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)
- `media` (array of string; ≤ 4 items)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/quotes/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string",
    "media": [
      "string"
    ]
  }'
```

Response 200:

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

## X: Like (Quotes)

`POST /accounts/{accountId}/x/quotes/{itemId}/like`

Enterprise-only on X. Quote posts of one of your posts. Requires scopes: tweet.read, users.read, like.write. Generic route: /v1/accounts/{accountId}/focus/quotes.

Access: `write` · MCP tool: `x-quotes-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/x/quotes/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
}
```

## X: Unlike (Quotes)

`POST /accounts/{accountId}/x/quotes/{itemId}/unlike`

Enterprise-only on X. Quote posts of one of your posts. Requires scopes: tweet.read, users.read, like.write. Generic route: /v1/accounts/{accountId}/focus/quotes.

Access: `write` · MCP tool: `x-quotes-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/x/quotes/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
}
```

## X: Repost (Quotes)

`POST /accounts/{accountId}/x/quotes/{itemId}/repost`

Repost. Quote posts of one of your posts. Requires scopes: tweet.read, users.read, tweet.write. Generic route: /v1/accounts/{accountId}/focus/quotes.

Access: `write` · MCP tool: `x-quotes-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/x/quotes/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
}
```

## X: Bookmark (Quotes)

`POST /accounts/{accountId}/x/quotes/{itemId}/bookmark`

Bookmark. Quote posts of one of your posts. Requires scopes: tweet.read, users.read, bookmark.write. Generic route: /v1/accounts/{accountId}/focus/quotes.

Access: `write` · MCP tool: `x-quotes-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/x/quotes/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
}
```

## X: List Reposts of me

`GET /accounts/{accountId}/x/reposts-of-me`

GET /2/users/reposts_of_me. Your posts that other accounts reposted. Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read, timeline.read. Generic route: /v1/accounts/{accountId}/focus/reposts-of-me.

Access: `read` · MCP tool: `x-reposts-of-me-list`

### Path parameters

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

### Query parameters

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

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "text": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "url": "https://example.com",
      "kind": "post",
      "author_id": "string",
      "author_username": "string",
      "author_name": "string",
      "author_avatar_url": "https://example.com",
      "conversation_id": "string",
      "in_reply_to_user_id": "string",
      "reply_to_id": "string",
      "quoted_id": "string",
      "reposted_id": "string",
      "lang": "string",
      "reply_settings": "everyone",
      "community_id": "string",
      "possibly_sensitive": true,
      "paid_partnership": true,
      "editable_until": "2026-10-13T09:00:00.000Z",
      "edits_remaining": 1,
      "media": [
        {
          "media_key": "string",
          "type": "photo",
          "url": "https://example.com",
          "preview_image_url": "https://example.com",
          "width": 1,
          "height": 1
        }
      ],
      "poll": {
        "id": "string",
        "options": [
          {
            "position": null,
            "label": null,
            "votes": null
          }
        ],
        "total_votes": 1,
        "voting_status": "open",
        "end_datetime": "2026-10-13T09:00:00.000Z",
        "duration_minutes": 1
      },
      "likes": 1,
      "reposts": 1,
      "replies": 1,
      "quotes": 1,
      "bookmarks": 1,
      "impressions": 1
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## X: List Liked by

`GET /accounts/{accountId}/x/liking-users`

GET /2/tweets/:id/liking_users. Accounts that liked a post. Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read, users.read, like.read. Generic route: /v1/accounts/{accountId}/focus/liking-users.

Access: `read` · MCP tool: `x-liking-users-list`

### Path parameters

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

### Query parameters

- `cursor` (string): Pagination cursor (next_cursor)
- `limit` (integer; 1–100)
- `post_id` (string; required)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/liking-users?post_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "username": "string",
      "name": "string",
      "url": "https://example.com",
      "avatar_url": "https://example.com",
      "description": "string",
      "location": "string",
      "website": "https://example.com",
      "created_at": "2026-10-13T09:00:00.000Z",
      "protected": true,
      "verified": true,
      "verified_type": "blue",
      "followers": 1,
      "following": 1,
      "posts": 1,
      "listed": 1,
      "likes": 1,
      "media_count": 1
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## X: List Reposted by

`GET /accounts/{accountId}/x/reposted-by`

GET /2/tweets/:id/retweeted_by. Accounts that reposted a post. Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read, users.read. Generic route: /v1/accounts/{accountId}/focus/reposted-by.

Access: `read` · MCP tool: `x-reposted-by-list`

### Path parameters

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

### Query parameters

- `cursor` (string): Pagination cursor (next_cursor)
- `limit` (integer; 1–100)
- `post_id` (string; required)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/reposted-by?post_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "username": "string",
      "name": "string",
      "url": "https://example.com",
      "avatar_url": "https://example.com",
      "description": "string",
      "location": "string",
      "website": "https://example.com",
      "created_at": "2026-10-13T09:00:00.000Z",
      "protected": true,
      "verified": true,
      "verified_type": "blue",
      "followers": 1,
      "following": 1,
      "posts": 1,
      "listed": 1,
      "likes": 1,
      "media_count": 1
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## X: List Likes

`GET /accounts/{accountId}/x/liked-posts`

GET /2/users/:id/liked_tweets. Posts you liked. Liking and unliking are Enterprise-only on X. Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read, users.read, like.read. Generic route: /v1/accounts/{accountId}/focus/liked-posts.

Access: `read` · MCP tool: `x-liked-posts-list`

### Path parameters

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

### Query parameters

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

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "text": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "url": "https://example.com",
      "kind": "post",
      "author_id": "string",
      "author_username": "string",
      "author_name": "string",
      "author_avatar_url": "https://example.com",
      "conversation_id": "string",
      "in_reply_to_user_id": "string",
      "reply_to_id": "string",
      "quoted_id": "string",
      "reposted_id": "string",
      "lang": "string",
      "reply_settings": "everyone",
      "community_id": "string",
      "possibly_sensitive": true,
      "paid_partnership": true,
      "editable_until": "2026-10-13T09:00:00.000Z",
      "edits_remaining": 1,
      "media": [
        {
          "media_key": "string",
          "type": "photo",
          "url": "https://example.com",
          "preview_image_url": "https://example.com",
          "width": 1,
          "height": 1
        }
      ],
      "poll": {
        "id": "string",
        "options": [
          {
            "position": null,
            "label": null,
            "votes": null
          }
        ],
        "total_votes": 1,
        "voting_status": "open",
        "end_datetime": "2026-10-13T09:00:00.000Z",
        "duration_minutes": 1
      },
      "likes": 1,
      "reposts": 1,
      "replies": 1,
      "quotes": 1,
      "bookmarks": 1,
      "impressions": 1
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## X: Create a Likes item

`POST /accounts/{accountId}/x/liked-posts`

Like a post (Enterprise-only). Posts you liked. Liking and unliking are Enterprise-only on X. Requires scopes: tweet.read, users.read, like.read, like.write. Generic route: /v1/accounts/{accountId}/focus/liked-posts.

Access: `write` · MCP tool: `x-liked-posts-create` · Zernio: `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

- `post_id` (string; required)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/liked-posts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "post_id": "string"
  }'
```

Response 201:

```json
{
  "id": "string",
  "text": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "url": "https://example.com",
  "kind": "post",
  "author_id": "string",
  "author_username": "string",
  "author_name": "string",
  "author_avatar_url": "https://example.com",
  "conversation_id": "string",
  "in_reply_to_user_id": "string",
  "reply_to_id": "string",
  "quoted_id": "string",
  "reposted_id": "string",
  "lang": "string",
  "reply_settings": "everyone",
  "community_id": "string",
  "possibly_sensitive": true,
  "paid_partnership": true,
  "editable_until": "2026-10-13T09:00:00.000Z",
  "edits_remaining": 1,
  "media": [
    {
      "media_key": "string",
      "type": "photo",
      "url": "https://example.com",
      "preview_image_url": "https://example.com",
      "width": 1,
      "height": 1,
      "duration_ms": 1,
      "alt_text": "string",
      "view_count": 1
    }
  ],
  "poll": {
    "id": "string",
    "options": [
      {
        "position": 1,
        "label": "string",
        "votes": 1
      }
    ],
    "total_votes": 1,
    "voting_status": "open",
    "end_datetime": "2026-10-13T09:00:00.000Z",
    "duration_minutes": 1
  },
  "likes": 1,
  "reposts": 1,
  "replies": 1,
  "quotes": 1,
  "bookmarks": 1,
  "impressions": 1
}
```

## X: Delete a Likes item

`DELETE /accounts/{accountId}/x/liked-posts/{itemId}`

Unlike a post (Enterprise-only). Posts you liked. Liking and unliking are Enterprise-only on X. Requires scopes: tweet.read, users.read, like.read, like.write. Generic route: /v1/accounts/{accountId}/focus/liked-posts.

Access: `write` · MCP tool: `x-liked-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/x/liked-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
}
```

## X: List Bookmark folders

`GET /accounts/{accountId}/x/bookmark-folders`

GET /2/users/:id/bookmarks/folders. Cursor pagination: pass next_cursor back as cursor. Requires scopes: users.read, bookmark.read. Generic route: /v1/accounts/{accountId}/focus/bookmark-folders.

Access: `read` · MCP tool: `x-bookmark-folders-list`

### Path parameters

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

### Query parameters

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

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## X: Create a Bookmark folders item

`POST /accounts/{accountId}/x/bookmark-folders`

POST /2/users/:id/bookmarks/folders. Requires scopes: users.read, bookmark.read, bookmark.write. Generic route: /v1/accounts/{accountId}/focus/bookmark-folders.

Access: `write` · MCP tool: `x-bookmark-folders-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; 1–25 characters)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/bookmark-folders" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string"
  }'
```

Response 201:

```json
{
  "id": "string",
  "name": "string"
}
```

## X: List Home timeline

`GET /accounts/{accountId}/x/home-timeline`

GET /2/users/:id/timelines/reverse_chronological. Posts from accounts you follow, newest first. Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read, users.read. Network docs: https://docs.x.com/x-api/posts/timelines/introduction Generic route: /v1/accounts/{accountId}/focus/home-timeline.

Access: `read` · MCP tool: `x-home-timeline-list`

### Path parameters

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

### Query parameters

- `cursor` (string): Pagination cursor (next_cursor)
- `limit` (integer; 1–100)
- `exclude` (string; one of replies, retweets, replies,retweets)
- `start_time` (string (date-time))
- `end_time` (string (date-time))

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "text": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "url": "https://example.com",
      "kind": "post",
      "author_id": "string",
      "author_username": "string",
      "author_name": "string",
      "author_avatar_url": "https://example.com",
      "conversation_id": "string",
      "in_reply_to_user_id": "string",
      "reply_to_id": "string",
      "quoted_id": "string",
      "reposted_id": "string",
      "lang": "string",
      "reply_settings": "everyone",
      "community_id": "string",
      "possibly_sensitive": true,
      "paid_partnership": true,
      "editable_until": "2026-10-13T09:00:00.000Z",
      "edits_remaining": 1,
      "media": [
        {
          "media_key": "string",
          "type": "photo",
          "url": "https://example.com",
          "preview_image_url": "https://example.com",
          "width": 1,
          "height": 1
        }
      ],
      "poll": {
        "id": "string",
        "options": [
          {
            "position": null,
            "label": null,
            "votes": null
          }
        ],
        "total_votes": 1,
        "voting_status": "open",
        "end_datetime": "2026-10-13T09:00:00.000Z",
        "duration_minutes": 1
      },
      "likes": 1,
      "reposts": 1,
      "replies": 1,
      "quotes": 1,
      "bookmarks": 1,
      "impressions": 1
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## X: Reply (Home timeline)

`POST /accounts/{accountId}/x/home-timeline/{itemId}/reply`

Reply. Posts from accounts you follow, newest first. Requires scopes: tweet.read, users.read, tweet.write. Network docs: https://docs.x.com/x-api/posts/timelines/introduction Generic route: /v1/accounts/{accountId}/focus/home-timeline.

Access: `write` · MCP tool: `x-home-timeline-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)
- `media` (array of string; ≤ 4 items)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/home-timeline/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string",
    "media": [
      "string"
    ]
  }'
```

Response 200:

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

## X: Like (Home timeline)

`POST /accounts/{accountId}/x/home-timeline/{itemId}/like`

Enterprise-only on X. Posts from accounts you follow, newest first. Requires scopes: tweet.read, users.read, like.write. Network docs: https://docs.x.com/x-api/posts/timelines/introduction Generic route: /v1/accounts/{accountId}/focus/home-timeline.

Access: `write` · MCP tool: `x-home-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/x/home-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
}
```

## X: Unlike (Home timeline)

`POST /accounts/{accountId}/x/home-timeline/{itemId}/unlike`

Enterprise-only on X. Posts from accounts you follow, newest first. Requires scopes: tweet.read, users.read, like.write. Network docs: https://docs.x.com/x-api/posts/timelines/introduction Generic route: /v1/accounts/{accountId}/focus/home-timeline.

Access: `write` · MCP tool: `x-home-timeline-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/x/home-timeline/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
}
```

## X: Repost (Home timeline)

`POST /accounts/{accountId}/x/home-timeline/{itemId}/repost`

Repost. Posts from accounts you follow, newest first. Requires scopes: tweet.read, users.read, tweet.write. Network docs: https://docs.x.com/x-api/posts/timelines/introduction Generic route: /v1/accounts/{accountId}/focus/home-timeline.

Access: `write` · MCP tool: `x-home-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/x/home-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
}
```

## X: Bookmark (Home timeline)

`POST /accounts/{accountId}/x/home-timeline/{itemId}/bookmark`

Bookmark. Posts from accounts you follow, newest first. Requires scopes: tweet.read, users.read, bookmark.write. Network docs: https://docs.x.com/x-api/posts/timelines/introduction Generic route: /v1/accounts/{accountId}/focus/home-timeline.

Access: `write` · MCP tool: `x-home-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/x/home-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
}
```

## X: Get Profile

`GET /accounts/{accountId}/x/profile`

GET /2/users/me. The connected account: handle, bio, verification and public counts. X has no profile-editing API. Requires scopes: users.read, tweet.read. Generic route: /v1/accounts/{accountId}/focus/profile.

Access: `read` · MCP tool: `x-profile-get`

### Path parameters

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

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

Response 200:

```json
{
  "id": "string",
  "username": "string",
  "name": "string",
  "url": "https://example.com",
  "avatar_url": "https://example.com",
  "description": "string",
  "location": "string",
  "website": "https://example.com",
  "created_at": "2026-10-13T09:00:00.000Z",
  "protected": true,
  "verified": true,
  "verified_type": "blue",
  "followers": 1,
  "following": 1,
  "posts": 1,
  "listed": 1,
  "likes": 1,
  "media_count": 1,
  "confirmed_email": "you@example.com",
  "subscription_type": "string",
  "verified_followers_count": 1,
  "pinned_post_id": "string"
}
```

## X: List Followers

`GET /accounts/{accountId}/x/followers`

GET /2/users/:id/followers ($0.010 per user returned). Cursor pagination: pass next_cursor back as cursor. Requires scopes: follows.read, users.read, tweet.read. Generic route: /v1/accounts/{accountId}/focus/followers.

Access: `read` · MCP tool: `x-followers-list`

### Path parameters

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

### Query parameters

- `cursor` (string): Pagination cursor (next_cursor)
- `limit` (integer; 1–1000)
- `user_id` (string): Defaults to the connected account

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "username": "string",
      "name": "string",
      "url": "https://example.com",
      "avatar_url": "https://example.com",
      "description": "string",
      "location": "string",
      "website": "https://example.com",
      "created_at": "2026-10-13T09:00:00.000Z",
      "protected": true,
      "verified": true,
      "verified_type": "blue",
      "followers": 1,
      "following": 1,
      "posts": 1,
      "listed": 1,
      "likes": 1,
      "media_count": 1
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## X: Follow (Followers)

`POST /accounts/{accountId}/x/followers/{itemId}/follow`

Enterprise-only on X. Requires scopes: follows.read, users.read, tweet.read, follows.write. Generic route: /v1/accounts/{accountId}/focus/followers.

Access: `write` · MCP tool: `x-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/x/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
}
```

## X: Unfollow (Followers)

`POST /accounts/{accountId}/x/followers/{itemId}/unfollow`

Enterprise-only on X. Requires scopes: follows.read, users.read, tweet.read, follows.write. Generic route: /v1/accounts/{accountId}/focus/followers.

Access: `write` · MCP tool: `x-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/x/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
}
```

## X: Mute (Followers)

`POST /accounts/{accountId}/x/followers/{itemId}/mute`

Mute. Requires scopes: follows.read, users.read, tweet.read, mute.write. Generic route: /v1/accounts/{accountId}/focus/followers.

Access: `write` · MCP tool: `x-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/x/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
}
```

## X: Unmute (Followers)

`POST /accounts/{accountId}/x/followers/{itemId}/unmute`

Unmute. Requires scopes: follows.read, users.read, tweet.read, mute.write. Generic route: /v1/accounts/{accountId}/focus/followers.

Access: `write` · MCP tool: `x-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/x/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
}
```

## X: Block (Followers)

`POST /accounts/{accountId}/x/followers/{itemId}/block`

Enterprise-only on X. Destructive. Requires scopes: follows.read, users.read, tweet.read, block.write. Generic route: /v1/accounts/{accountId}/focus/followers.

Access: `write` · MCP tool: `x-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/x/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
}
```

## X: Unblock (Followers)

`POST /accounts/{accountId}/x/followers/{itemId}/unblock`

Enterprise-only on X. Requires scopes: follows.read, users.read, tweet.read, block.write. Generic route: /v1/accounts/{accountId}/focus/followers.

Access: `write` · MCP tool: `x-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/x/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
}
```

## X: Block DMs (Followers)

`POST /accounts/{accountId}/x/followers/{itemId}/block-dms`

Block DMs. Requires scopes: follows.read, users.read, tweet.read, dm.write. Generic route: /v1/accounts/{accountId}/focus/followers.

Access: `write` · MCP tool: `x-followers-block-dms`

### 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/x/followers/ITEM_ID/block-dms" \
  -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
}
```

## X: Unblock DMs (Followers)

`POST /accounts/{accountId}/x/followers/{itemId}/unblock-dms`

Unblock DMs. Requires scopes: follows.read, users.read, tweet.read, dm.write. Generic route: /v1/accounts/{accountId}/focus/followers.

Access: `write` · MCP tool: `x-followers-unblock-dms`

### 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/x/followers/ITEM_ID/unblock-dms" \
  -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
}
```

## X: Send DM (Followers)

`POST /accounts/{accountId}/x/followers/{itemId}/send-dm`

Send DM. Requires scopes: follows.read, users.read, tweet.read, dm.write, dm.read. Generic route: /v1/accounts/{accountId}/focus/followers.

Access: `write` · MCP tool: `x-followers-send-dm`

### 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; ≤ 10000 characters)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/followers/ITEM_ID/send-dm" \
  -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
}
```

## X: Follow (Following)

`POST /accounts/{accountId}/x/following/{itemId}/follow`

Enterprise-only on X. Accounts you follow. Follow/unfollow are Enterprise-only on X since 2026-04-20. Requires scopes: follows.read, users.read, tweet.read, follows.write. Generic route: /v1/accounts/{accountId}/focus/following.

Access: `write` · MCP tool: `x-following-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/x/following/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
}
```

## X: Unfollow (Following)

`POST /accounts/{accountId}/x/following/{itemId}/unfollow`

Enterprise-only on X. Accounts you follow. Follow/unfollow are Enterprise-only on X since 2026-04-20. Requires scopes: follows.read, users.read, tweet.read, follows.write. Generic route: /v1/accounts/{accountId}/focus/following.

Access: `write` · MCP tool: `x-following-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/x/following/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
}
```

## X: Mute (Following)

`POST /accounts/{accountId}/x/following/{itemId}/mute`

Mute. Accounts you follow. Follow/unfollow are Enterprise-only on X since 2026-04-20. Requires scopes: follows.read, users.read, tweet.read, mute.write. Generic route: /v1/accounts/{accountId}/focus/following.

Access: `write` · MCP tool: `x-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/x/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
}
```

## X: Unmute (Following)

`POST /accounts/{accountId}/x/following/{itemId}/unmute`

Unmute. Accounts you follow. Follow/unfollow are Enterprise-only on X since 2026-04-20. Requires scopes: follows.read, users.read, tweet.read, mute.write. Generic route: /v1/accounts/{accountId}/focus/following.

Access: `write` · MCP tool: `x-following-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/x/following/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
}
```

## X: Block (Following)

`POST /accounts/{accountId}/x/following/{itemId}/block`

Enterprise-only on X. Accounts you follow. Follow/unfollow are Enterprise-only on X since 2026-04-20. Destructive. Requires scopes: follows.read, users.read, tweet.read, block.write. Generic route: /v1/accounts/{accountId}/focus/following.

Access: `write` · MCP tool: `x-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/x/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
}
```

## X: Unblock (Following)

`POST /accounts/{accountId}/x/following/{itemId}/unblock`

Enterprise-only on X. Accounts you follow. Follow/unfollow are Enterprise-only on X since 2026-04-20. Requires scopes: follows.read, users.read, tweet.read, block.write. Generic route: /v1/accounts/{accountId}/focus/following.

Access: `write` · MCP tool: `x-following-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/x/following/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
}
```

## X: Block DMs (Following)

`POST /accounts/{accountId}/x/following/{itemId}/block-dms`

Block DMs. Accounts you follow. Follow/unfollow are Enterprise-only on X since 2026-04-20. Requires scopes: follows.read, users.read, tweet.read, dm.write. Generic route: /v1/accounts/{accountId}/focus/following.

Access: `write` · MCP tool: `x-following-block-dms`

### 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/x/following/ITEM_ID/block-dms" \
  -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
}
```

## X: Unblock DMs (Following)

`POST /accounts/{accountId}/x/following/{itemId}/unblock-dms`

Unblock DMs. Accounts you follow. Follow/unfollow are Enterprise-only on X since 2026-04-20. Requires scopes: follows.read, users.read, tweet.read, dm.write. Generic route: /v1/accounts/{accountId}/focus/following.

Access: `write` · MCP tool: `x-following-unblock-dms`

### 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/x/following/ITEM_ID/unblock-dms" \
  -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
}
```

## X: Send DM (Following)

`POST /accounts/{accountId}/x/following/{itemId}/send-dm`

Send DM. Accounts you follow. Follow/unfollow are Enterprise-only on X since 2026-04-20. Requires scopes: follows.read, users.read, tweet.read, dm.write, dm.read. Generic route: /v1/accounts/{accountId}/focus/following.

Access: `write` · MCP tool: `x-following-send-dm`

### 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; ≤ 10000 characters)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/following/ITEM_ID/send-dm" \
  -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
}
```

## X: List People

`GET /accounts/{accountId}/x/users`

GET /2/users/search. Search and look up X accounts; follow, mute, block or DM them. Cursor pagination: pass next_cursor back as cursor. Requires scopes: users.read, tweet.read. Generic route: /v1/accounts/{accountId}/focus/users.

Access: `read` · MCP tool: `x-users-list`

### Path parameters

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

### Query parameters

- `cursor` (string): Pagination cursor (next_cursor)
- `limit` (integer; 1–100)
- `q` (string; required): Name or handle

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "username": "string",
      "name": "string",
      "url": "https://example.com",
      "avatar_url": "https://example.com",
      "description": "string",
      "location": "string",
      "website": "https://example.com",
      "created_at": "2026-10-13T09:00:00.000Z",
      "protected": true,
      "verified": true,
      "verified_type": "blue",
      "followers": 1,
      "following": 1,
      "posts": 1,
      "listed": 1,
      "likes": 1,
      "media_count": 1
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## X: Get a People item

`GET /accounts/{accountId}/x/users/{itemId}`

GET /2/users/:id or /2/users/by/username/:username. Search and look up X accounts; follow, mute, block or DM them. Requires scopes: users.read, tweet.read. Generic route: /v1/accounts/{accountId}/focus/users.

Access: `read` · MCP tool: `x-users-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/x/users/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "username": "string",
  "name": "string",
  "url": "https://example.com",
  "avatar_url": "https://example.com",
  "description": "string",
  "location": "string",
  "website": "https://example.com",
  "created_at": "2026-10-13T09:00:00.000Z",
  "protected": true,
  "verified": true,
  "verified_type": "blue",
  "followers": 1,
  "following": 1,
  "posts": 1,
  "listed": 1,
  "likes": 1,
  "media_count": 1
}
```

## X: Follow (People)

`POST /accounts/{accountId}/x/users/{itemId}/follow`

Enterprise-only on X. Search and look up X accounts; follow, mute, block or DM them. Requires scopes: users.read, tweet.read, follows.write. Generic route: /v1/accounts/{accountId}/focus/users.

Access: `write` · MCP tool: `x-users-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/x/users/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
}
```

## X: Unfollow (People)

`POST /accounts/{accountId}/x/users/{itemId}/unfollow`

Enterprise-only on X. Search and look up X accounts; follow, mute, block or DM them. Requires scopes: users.read, tweet.read, follows.write. Generic route: /v1/accounts/{accountId}/focus/users.

Access: `write` · MCP tool: `x-users-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/x/users/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
}
```

## X: Mute (People)

`POST /accounts/{accountId}/x/users/{itemId}/mute`

Mute. Search and look up X accounts; follow, mute, block or DM them. Requires scopes: users.read, tweet.read, mute.write. Generic route: /v1/accounts/{accountId}/focus/users.

Access: `write` · MCP tool: `x-users-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/x/users/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
}
```

## X: Unmute (People)

`POST /accounts/{accountId}/x/users/{itemId}/unmute`

Unmute. Search and look up X accounts; follow, mute, block or DM them. Requires scopes: users.read, tweet.read, mute.write. Generic route: /v1/accounts/{accountId}/focus/users.

Access: `write` · MCP tool: `x-users-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/x/users/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
}
```

## X: Block (People)

`POST /accounts/{accountId}/x/users/{itemId}/block`

Enterprise-only on X. Search and look up X accounts; follow, mute, block or DM them. Destructive. Requires scopes: users.read, tweet.read, block.write. Generic route: /v1/accounts/{accountId}/focus/users.

Access: `write` · MCP tool: `x-users-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/x/users/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
}
```

## X: Unblock (People)

`POST /accounts/{accountId}/x/users/{itemId}/unblock`

Enterprise-only on X. Search and look up X accounts; follow, mute, block or DM them. Requires scopes: users.read, tweet.read, block.write. Generic route: /v1/accounts/{accountId}/focus/users.

Access: `write` · MCP tool: `x-users-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/x/users/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
}
```

## X: Block DMs (People)

`POST /accounts/{accountId}/x/users/{itemId}/block-dms`

Block DMs. Search and look up X accounts; follow, mute, block or DM them. Requires scopes: users.read, tweet.read, dm.write. Generic route: /v1/accounts/{accountId}/focus/users.

Access: `write` · MCP tool: `x-users-block-dms`

### 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/x/users/ITEM_ID/block-dms" \
  -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
}
```

## X: Unblock DMs (People)

`POST /accounts/{accountId}/x/users/{itemId}/unblock-dms`

Unblock DMs. Search and look up X accounts; follow, mute, block or DM them. Requires scopes: users.read, tweet.read, dm.write. Generic route: /v1/accounts/{accountId}/focus/users.

Access: `write` · MCP tool: `x-users-unblock-dms`

### 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/x/users/ITEM_ID/unblock-dms" \
  -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
}
```

## X: Send DM (People)

`POST /accounts/{accountId}/x/users/{itemId}/send-dm`

Send DM. Search and look up X accounts; follow, mute, block or DM them. Requires scopes: users.read, tweet.read, dm.write, dm.read. Generic route: /v1/accounts/{accountId}/focus/users.

Access: `write` · MCP tool: `x-users-send-dm`

### 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; ≤ 10000 characters)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/users/ITEM_ID/send-dm" \
  -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
}
```

## X: List Affiliates

`GET /accounts/{accountId}/x/affiliates`

GET /2/users/:id/affiliates. Accounts affiliated with a verified organization. Cursor pagination: pass next_cursor back as cursor. Requires scopes: users.read, tweet.read. Generic route: /v1/accounts/{accountId}/focus/affiliates.

Access: `read` · MCP tool: `x-affiliates-list`

### Path parameters

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

### Query parameters

- `cursor` (string): Pagination cursor (next_cursor)
- `limit` (integer; 1–100)
- `user_id` (string)

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "username": "string",
      "name": "string",
      "url": "https://example.com",
      "avatar_url": "https://example.com",
      "description": "string",
      "location": "string",
      "website": "https://example.com",
      "created_at": "2026-10-13T09:00:00.000Z",
      "protected": true,
      "verified": true,
      "verified_type": "blue",
      "followers": 1,
      "following": 1,
      "posts": 1,
      "listed": 1,
      "likes": 1,
      "media_count": 1
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## X: List Muted accounts

`GET /accounts/{accountId}/x/mutes`

GET /2/users/:id/muting. Cursor pagination: pass next_cursor back as cursor. Requires scopes: mute.read, users.read, tweet.read. Network docs: https://docs.x.com/x-api/users/mutes/introduction Generic route: /v1/accounts/{accountId}/focus/mutes.

Access: `read` · MCP tool: `x-mutes-list`

### Path parameters

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

### Query parameters

- `cursor` (string): Pagination cursor (next_cursor)
- `limit` (integer; 1–1000)

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "username": "string",
      "name": "string",
      "url": "https://example.com",
      "avatar_url": "https://example.com",
      "description": "string",
      "location": "string",
      "website": "https://example.com",
      "created_at": "2026-10-13T09:00:00.000Z",
      "protected": true,
      "verified": true,
      "verified_type": "blue",
      "followers": 1,
      "following": 1,
      "posts": 1,
      "listed": 1,
      "likes": 1,
      "media_count": 1
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## X: Create a Muted accounts item

`POST /accounts/{accountId}/x/mutes`

Mute a user. Requires scopes: mute.read, users.read, tweet.read, mute.write. Network docs: https://docs.x.com/x-api/users/mutes/introduction Generic route: /v1/accounts/{accountId}/focus/mutes.

Access: `write` · MCP tool: `x-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

- `user_id` (string)
- `username` (string)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/mutes" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "string",
    "username": "string"
  }'
```

Response 201:

```json
{
  "id": "string",
  "username": "string",
  "name": "string",
  "url": "https://example.com",
  "avatar_url": "https://example.com",
  "description": "string",
  "location": "string",
  "website": "https://example.com",
  "created_at": "2026-10-13T09:00:00.000Z",
  "protected": true,
  "verified": true,
  "verified_type": "blue",
  "followers": 1,
  "following": 1,
  "posts": 1,
  "listed": 1,
  "likes": 1,
  "media_count": 1
}
```

## X: Delete a Muted accounts item

`DELETE /accounts/{accountId}/x/mutes/{itemId}`

Unmute. Requires scopes: mute.read, users.read, tweet.read, mute.write. Network docs: https://docs.x.com/x-api/users/mutes/introduction Generic route: /v1/accounts/{accountId}/focus/mutes.

Access: `write` · MCP tool: `x-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/x/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
}
```

## X: List Blocked accounts

`GET /accounts/{accountId}/x/blocks`

GET /2/users/:id/blocking. Reading the block list is self-serve; block/unblock are Enterprise-only on X. Cursor pagination: pass next_cursor back as cursor. Requires scopes: block.read, users.read, tweet.read. Network docs: https://docs.x.com/x-api/users/blocks/introduction Generic route: /v1/accounts/{accountId}/focus/blocks.

Access: `read` · MCP tool: `x-blocks-list`

### Path parameters

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

### Query parameters

- `cursor` (string): Pagination cursor (next_cursor)
- `limit` (integer; 1–1000)

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "username": "string",
      "name": "string",
      "url": "https://example.com",
      "avatar_url": "https://example.com",
      "description": "string",
      "location": "string",
      "website": "https://example.com",
      "created_at": "2026-10-13T09:00:00.000Z",
      "protected": true,
      "verified": true,
      "verified_type": "blue",
      "followers": 1,
      "following": 1,
      "posts": 1,
      "listed": 1,
      "likes": 1,
      "media_count": 1
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## X: Create a Blocked accounts item

`POST /accounts/{accountId}/x/blocks`

Block a user (Enterprise-only). Reading the block list is self-serve; block/unblock are Enterprise-only on X. Requires scopes: block.read, users.read, tweet.read, block.write. Network docs: https://docs.x.com/x-api/users/blocks/introduction Generic route: /v1/accounts/{accountId}/focus/blocks.

Access: `write` · MCP tool: `x-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

- `user_id` (string)
- `username` (string)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/blocks" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "string",
    "username": "string"
  }'
```

Response 201:

```json
{
  "id": "string",
  "username": "string",
  "name": "string",
  "url": "https://example.com",
  "avatar_url": "https://example.com",
  "description": "string",
  "location": "string",
  "website": "https://example.com",
  "created_at": "2026-10-13T09:00:00.000Z",
  "protected": true,
  "verified": true,
  "verified_type": "blue",
  "followers": 1,
  "following": 1,
  "posts": 1,
  "listed": 1,
  "likes": 1,
  "media_count": 1
}
```

## X: Delete a Blocked accounts item

`DELETE /accounts/{accountId}/x/blocks/{itemId}`

Unblock (Enterprise-only). Reading the block list is self-serve; block/unblock are Enterprise-only on X. Requires scopes: block.read, users.read, tweet.read, block.write. Network docs: https://docs.x.com/x-api/users/blocks/introduction Generic route: /v1/accounts/{accountId}/focus/blocks.

Access: `write` · MCP tool: `x-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/x/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
}
```

## X: List My lists

`GET /accounts/{accountId}/x/lists`

GET /2/users/:id/owned_lists. Lists you own: create, edit, delete, add or remove members, follow and pin. Cursor pagination: pass next_cursor back as cursor. Requires scopes: list.read, users.read, tweet.read. Network docs: https://docs.x.com/x-api/lists/introduction Generic route: /v1/accounts/{accountId}/focus/lists.

Access: `read` · MCP tool: `x-lists-list`

### Path parameters

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

### Query parameters

- `cursor` (string): Pagination cursor (next_cursor)
- `limit` (integer; 1–100)
- `user_id` (string)

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "description": "string",
      "private": false,
      "member_count": 1,
      "follower_count": 1,
      "created_at": "2026-10-13T09:00:00.000Z",
      "owner_id": "string",
      "owner_username": "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"
}
```

## X: Create a My lists item

`POST /accounts/{accountId}/x/lists`

POST /2/lists. Lists you own: create, edit, delete, add or remove members, follow and pin. Requires scopes: list.read, users.read, tweet.read, list.write. Network docs: https://docs.x.com/x-api/lists/introduction Generic route: /v1/accounts/{accountId}/focus/lists.

Access: `write` · MCP tool: `x-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; 1–25 characters)
- `description` (string; ≤ 100 characters)
- `private` (boolean)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/lists" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "description": "string",
    "private": true
  }'
```

Response 201:

```json
{
  "id": "string",
  "name": "string",
  "description": "string",
  "private": false,
  "member_count": 1,
  "follower_count": 1,
  "created_at": "2026-10-13T09:00:00.000Z",
  "owner_id": "string",
  "owner_username": "string",
  "url": "https://example.com"
}
```

## X: Get a My lists item

`GET /accounts/{accountId}/x/lists/{itemId}`

GET /2/lists/:id. Lists you own: create, edit, delete, add or remove members, follow and pin. Requires scopes: list.read, users.read, tweet.read. Network docs: https://docs.x.com/x-api/lists/introduction Generic route: /v1/accounts/{accountId}/focus/lists.

Access: `read` · MCP tool: `x-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/x/lists/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "name": "string",
  "description": "string",
  "private": false,
  "member_count": 1,
  "follower_count": 1,
  "created_at": "2026-10-13T09:00:00.000Z",
  "owner_id": "string",
  "owner_username": "string",
  "url": "https://example.com"
}
```

## X: Update a My lists item

`PATCH /accounts/{accountId}/x/lists/{itemId}`

PUT /2/lists/:id. Lists you own: create, edit, delete, add or remove members, follow and pin. Requires scopes: list.read, users.read, tweet.read, list.write. Network docs: https://docs.x.com/x-api/lists/introduction Generic route: /v1/accounts/{accountId}/focus/lists.

Access: `write` · MCP tool: `x-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; 1–25 characters)
- `description` (string; ≤ 100 characters)
- `private` (boolean)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/lists/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "description": "string",
    "private": true
  }'
```

Response 200:

```json
{
  "id": "string",
  "name": "string",
  "description": "string",
  "private": false,
  "member_count": 1,
  "follower_count": 1,
  "created_at": "2026-10-13T09:00:00.000Z",
  "owner_id": "string",
  "owner_username": "string",
  "url": "https://example.com"
}
```

## X: Delete a My lists item

`DELETE /accounts/{accountId}/x/lists/{itemId}`

DELETE /2/lists/:id. Lists you own: create, edit, delete, add or remove members, follow and pin. Requires scopes: list.read, users.read, tweet.read, list.write. Network docs: https://docs.x.com/x-api/lists/introduction Generic route: /v1/accounts/{accountId}/focus/lists.

Access: `write` · MCP tool: `x-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/x/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
}
```

## X: Add member (My lists)

`POST /accounts/{accountId}/x/lists/{itemId}/add-member`

Add member. Lists you own: create, edit, delete, add or remove members, follow and pin. Requires scopes: list.read, users.read, tweet.read, list.write. Network docs: https://docs.x.com/x-api/lists/introduction Generic route: /v1/accounts/{accountId}/focus/lists.

Access: `write` · MCP tool: `x-lists-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

- `user_id` (string)
- `username` (string)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/lists/ITEM_ID/add-member" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "string",
    "username": "string"
  }'
```

Response 200:

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

## X: Remove member (My lists)

`POST /accounts/{accountId}/x/lists/{itemId}/remove-member`

Remove member. Lists you own: create, edit, delete, add or remove members, follow and pin. Requires scopes: list.read, users.read, tweet.read, list.write. Network docs: https://docs.x.com/x-api/lists/introduction Generic route: /v1/accounts/{accountId}/focus/lists.

Access: `write` · MCP tool: `x-lists-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

- `user_id` (string; required)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/lists/ITEM_ID/remove-member" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "string"
  }'
```

Response 200:

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

## X: Follow list (My lists)

`POST /accounts/{accountId}/x/lists/{itemId}/follow`

Follow list. Lists you own: create, edit, delete, add or remove members, follow and pin. Requires scopes: list.read, users.read, tweet.read, list.write. Network docs: https://docs.x.com/x-api/lists/introduction Generic route: /v1/accounts/{accountId}/focus/lists.

Access: `write` · MCP tool: `x-lists-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/x/lists/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
}
```

## X: Unfollow list (My lists)

`POST /accounts/{accountId}/x/lists/{itemId}/unfollow`

Unfollow list. Lists you own: create, edit, delete, add or remove members, follow and pin. Requires scopes: list.read, users.read, tweet.read, list.write. Network docs: https://docs.x.com/x-api/lists/introduction Generic route: /v1/accounts/{accountId}/focus/lists.

Access: `write` · MCP tool: `x-lists-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/x/lists/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
}
```

## X: Pin (My lists)

`POST /accounts/{accountId}/x/lists/{itemId}/pin`

Pin. Lists you own: create, edit, delete, add or remove members, follow and pin. Requires scopes: list.read, users.read, tweet.read, list.write. Network docs: https://docs.x.com/x-api/lists/introduction Generic route: /v1/accounts/{accountId}/focus/lists.

Access: `write` · MCP tool: `x-lists-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/x/lists/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
}
```

## X: Unpin (My lists)

`POST /accounts/{accountId}/x/lists/{itemId}/unpin`

Unpin. Lists you own: create, edit, delete, add or remove members, follow and pin. Requires scopes: list.read, users.read, tweet.read, list.write. Network docs: https://docs.x.com/x-api/lists/introduction Generic route: /v1/accounts/{accountId}/focus/lists.

Access: `write` · MCP tool: `x-lists-unpin`

### 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/x/lists/ITEM_ID/unpin" \
  -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
}
```

## X: List List members

`GET /accounts/{accountId}/x/list-members`

GET /2/lists/:id/members (item id = "<list_id>:<user_id>"). Cursor pagination: pass next_cursor back as cursor. Requires scopes: list.read, users.read, tweet.read. Generic route: /v1/accounts/{accountId}/focus/list-members.

Access: `read` · MCP tool: `x-list-members-list`

### Path parameters

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

### Query parameters

- `cursor` (string): Pagination cursor (next_cursor)
- `limit` (integer; 1–100)
- `list_id` (string; required)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/list-members?list_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "username": "string",
      "name": "string",
      "url": "https://example.com",
      "avatar_url": "https://example.com",
      "description": "string",
      "location": "string",
      "website": "https://example.com",
      "created_at": "2026-10-13T09:00:00.000Z",
      "protected": true,
      "verified": true,
      "verified_type": "blue",
      "followers": 1,
      "following": 1,
      "posts": 1,
      "listed": 1,
      "likes": 1,
      "media_count": 1,
      "list_id": "string",
      "user_id": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## X: Create a List members item

`POST /accounts/{accountId}/x/list-members`

POST /2/lists/:id/members. Requires scopes: list.read, users.read, tweet.read, list.write. Generic route: /v1/accounts/{accountId}/focus/list-members.

Access: `write` · MCP tool: `x-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_id` (string; required)
- `user_id` (string)
- `username` (string)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/list-members" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "list_id": "string",
    "user_id": "string",
    "username": "string"
  }'
```

Response 201:

```json
{
  "id": "string",
  "username": "string",
  "name": "string",
  "url": "https://example.com",
  "avatar_url": "https://example.com",
  "description": "string",
  "location": "string",
  "website": "https://example.com",
  "created_at": "2026-10-13T09:00:00.000Z",
  "protected": true,
  "verified": true,
  "verified_type": "blue",
  "followers": 1,
  "following": 1,
  "posts": 1,
  "listed": 1,
  "likes": 1,
  "media_count": 1,
  "list_id": "string",
  "user_id": "string"
}
```

## X: Delete a List members item

`DELETE /accounts/{accountId}/x/list-members/{itemId}`

DELETE /2/lists/:id/members/:user_id. Requires scopes: list.read, users.read, tweet.read, list.write. Generic route: /v1/accounts/{accountId}/focus/list-members.

Access: `write` · MCP tool: `x-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/x/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
}
```

## X: List List followers

`GET /accounts/{accountId}/x/list-followers`

GET /2/lists/:id/followers. Cursor pagination: pass next_cursor back as cursor. Requires scopes: list.read, users.read, tweet.read. Generic route: /v1/accounts/{accountId}/focus/list-followers.

Access: `read` · MCP tool: `x-list-followers-list`

### Path parameters

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

### Query parameters

- `cursor` (string): Pagination cursor (next_cursor)
- `limit` (integer; 1–100)
- `list_id` (string; required)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/list-followers?list_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "username": "string",
      "name": "string",
      "url": "https://example.com",
      "avatar_url": "https://example.com",
      "description": "string",
      "location": "string",
      "website": "https://example.com",
      "created_at": "2026-10-13T09:00:00.000Z",
      "protected": true,
      "verified": true,
      "verified_type": "blue",
      "followers": 1,
      "following": 1,
      "posts": 1,
      "listed": 1,
      "likes": 1,
      "media_count": 1
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## X: List List timeline

`GET /accounts/{accountId}/x/list-posts`

GET /2/lists/:id/tweets. Cursor pagination: pass next_cursor back as cursor. Requires scopes: list.read, users.read, tweet.read. Generic route: /v1/accounts/{accountId}/focus/list-posts.

Access: `read` · MCP tool: `x-list-posts-list`

### Path parameters

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

### Query parameters

- `cursor` (string): Pagination cursor (next_cursor)
- `limit` (integer; 1–100)
- `list_id` (string; required)

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "text": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "url": "https://example.com",
      "kind": "post",
      "author_id": "string",
      "author_username": "string",
      "author_name": "string",
      "author_avatar_url": "https://example.com",
      "conversation_id": "string",
      "in_reply_to_user_id": "string",
      "reply_to_id": "string",
      "quoted_id": "string",
      "reposted_id": "string",
      "lang": "string",
      "reply_settings": "everyone",
      "community_id": "string",
      "possibly_sensitive": true,
      "paid_partnership": true,
      "editable_until": "2026-10-13T09:00:00.000Z",
      "edits_remaining": 1,
      "media": [
        {
          "media_key": "string",
          "type": "photo",
          "url": "https://example.com",
          "preview_image_url": "https://example.com",
          "width": 1,
          "height": 1
        }
      ],
      "poll": {
        "id": "string",
        "options": [
          {
            "position": null,
            "label": null,
            "votes": null
          }
        ],
        "total_votes": 1,
        "voting_status": "open",
        "end_datetime": "2026-10-13T09:00:00.000Z",
        "duration_minutes": 1
      },
      "likes": 1,
      "reposts": 1,
      "replies": 1,
      "quotes": 1,
      "bookmarks": 1,
      "impressions": 1
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## X: List Followed lists

`GET /accounts/{accountId}/x/followed-lists`

GET /2/users/:id/followed_lists. Cursor pagination: pass next_cursor back as cursor. Requires scopes: list.read, users.read, tweet.read. Generic route: /v1/accounts/{accountId}/focus/followed-lists.

Access: `read` · MCP tool: `x-followed-lists-list`

### Path parameters

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

### Query parameters

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

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "description": "string",
      "private": false,
      "member_count": 1,
      "follower_count": 1,
      "created_at": "2026-10-13T09:00:00.000Z",
      "owner_id": "string",
      "owner_username": "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"
}
```

## X: Create a Followed lists item

`POST /accounts/{accountId}/x/followed-lists`

Follow a list. Requires scopes: list.read, users.read, tweet.read, list.write. Generic route: /v1/accounts/{accountId}/focus/followed-lists.

Access: `write` · MCP tool: `x-followed-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

- `list_id` (string; required)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/followed-lists" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "list_id": "string"
  }'
```

Response 201:

```json
{
  "id": "string",
  "name": "string",
  "description": "string",
  "private": false,
  "member_count": 1,
  "follower_count": 1,
  "created_at": "2026-10-13T09:00:00.000Z",
  "owner_id": "string",
  "owner_username": "string",
  "url": "https://example.com"
}
```

## X: Delete a Followed lists item

`DELETE /accounts/{accountId}/x/followed-lists/{itemId}`

Unfollow a list. Requires scopes: list.read, users.read, tweet.read, list.write. Generic route: /v1/accounts/{accountId}/focus/followed-lists.

Access: `write` · MCP tool: `x-followed-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/x/followed-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
}
```

## X: List Pinned lists

`GET /accounts/{accountId}/x/pinned-lists`

GET /2/users/:id/pinned_lists. Cursor pagination: pass next_cursor back as cursor. Requires scopes: list.read, users.read, tweet.read. Generic route: /v1/accounts/{accountId}/focus/pinned-lists.

Access: `read` · MCP tool: `x-pinned-lists-list`

### Path parameters

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

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "description": "string",
      "private": false,
      "member_count": 1,
      "follower_count": 1,
      "created_at": "2026-10-13T09:00:00.000Z",
      "owner_id": "string",
      "owner_username": "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"
}
```

## X: Create a Pinned lists item

`POST /accounts/{accountId}/x/pinned-lists`

Pin a list. Requires scopes: list.read, users.read, tweet.read, list.write. Generic route: /v1/accounts/{accountId}/focus/pinned-lists.

Access: `write` · MCP tool: `x-pinned-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

- `list_id` (string; required)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/pinned-lists" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "list_id": "string"
  }'
```

Response 201:

```json
{
  "id": "string",
  "name": "string",
  "description": "string",
  "private": false,
  "member_count": 1,
  "follower_count": 1,
  "created_at": "2026-10-13T09:00:00.000Z",
  "owner_id": "string",
  "owner_username": "string",
  "url": "https://example.com"
}
```

## X: Delete a Pinned lists item

`DELETE /accounts/{accountId}/x/pinned-lists/{itemId}`

Unpin a list. Requires scopes: list.read, users.read, tweet.read, list.write. Generic route: /v1/accounts/{accountId}/focus/pinned-lists.

Access: `write` · MCP tool: `x-pinned-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/x/pinned-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
}
```

## X: List Lists I am on

`GET /accounts/{accountId}/x/list-memberships`

GET /2/users/:id/list_memberships. Cursor pagination: pass next_cursor back as cursor. Requires scopes: list.read, users.read, tweet.read. Generic route: /v1/accounts/{accountId}/focus/list-memberships.

Access: `read` · MCP tool: `x-list-memberships-list`

### Path parameters

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

### Query parameters

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

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "description": "string",
      "private": false,
      "member_count": 1,
      "follower_count": 1,
      "created_at": "2026-10-13T09:00:00.000Z",
      "owner_id": "string",
      "owner_username": "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"
}
```

## X: List Direct messages

`GET /accounts/{accountId}/x/conversations`

Conversations grouped from GET /2/dm_events. DM conversations (legacy DM API). End-to-end encrypted X Chat threads are not readable here. Cursor pagination: pass next_cursor back as cursor. Requires scopes: dm.read, users.read, tweet.read. Network docs: https://docs.x.com/x-api/direct-messages/introduction Generic route: /v1/accounts/{accountId}/focus/conversations.

Access: `read` · MCP tool: `x-conversations-list` · Zernio: `GET /v1/inbox/conversations`, `GET /v1/inbox/conversations/{conversationId}/messages`

### Path parameters

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

### Query parameters

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

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "type": "one_to_one",
      "participants": [
        {
          "id": "string",
          "name": "string",
          "username": "string",
          "avatar_url": "https://example.com"
        }
      ],
      "last_message": "string",
      "last_sender_id": "string",
      "updated_at": "2026-10-13T09:00:00.000Z",
      "unread_count": 1,
      "message_count": 1,
      "messages": [
        {
          "id": "string",
          "text": "string",
          "direction": "in",
          "sent_at": "2026-10-13T09:00:00.000Z",
          "from_id": "string",
          "sender_username": "string"
        }
      ]
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## X: Create a Direct messages item

`POST /accounts/{accountId}/x/conversations`

Start a 1:1 conversation (participant id or @username) or a group (participant_ids). DM conversations (legacy DM API). End-to-end encrypted X Chat threads are not readable here. Requires scopes: dm.read, users.read, tweet.read, dm.write. Network docs: https://docs.x.com/x-api/direct-messages/introduction Generic route: /v1/accounts/{accountId}/focus/conversations.

Access: `write` · MCP tool: `x-conversations-create` · Zernio: `POST /v1/inbox/conversations`, `POST /v1/inbox/conversations/{conversationId}/messages`

### 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_id` (string)
- `participant_username` (string)
- `participant_ids` (array of string; 2–49 items): Group conversation
- `text` (string; ≤ 10000 characters)
- `media` (string)
- `skip_dm_check` (boolean)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/conversations" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "participant_id": "string",
    "participant_username": "string",
    "participant_ids": [
      "string"
    ],
    "text": "string",
    "media": "string"
  }'
```

Response 201:

```json
{
  "id": "string",
  "type": "one_to_one",
  "participants": [
    {
      "id": "string",
      "name": "string",
      "username": "string",
      "avatar_url": "https://example.com"
    }
  ],
  "last_message": "string",
  "last_sender_id": "string",
  "updated_at": "2026-10-13T09:00:00.000Z",
  "unread_count": 1,
  "message_count": 1,
  "messages": [
    {
      "id": "string",
      "text": "string",
      "direction": "in",
      "sent_at": "2026-10-13T09:00:00.000Z",
      "from_id": "string",
      "sender_username": "string",
      "sender_name": "string",
      "conversation_id": "string",
      "event_type": "MessageCreate",
      "attachments": [
        {
          "type": "string",
          "media_key": "string",
          "url": "https://example.com"
        }
      ]
    }
  ]
}
```

## X: Get a Direct messages item

`GET /accounts/{accountId}/x/conversations/{itemId}`

Messages in a conversation (GET /2/dm_conversations/:id/dm_events). DM conversations (legacy DM API). End-to-end encrypted X Chat threads are not readable here. Requires scopes: dm.read, users.read, tweet.read. Network docs: https://docs.x.com/x-api/direct-messages/introduction Generic route: /v1/accounts/{accountId}/focus/conversations.

Access: `read` · MCP tool: `x-conversations-get` · Zernio: `GET /v1/inbox/conversations/{conversationId}`, `GET /v1/inbox/conversations/{conversationId}/messages/{messageId}/attachments/{index}`

### 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/x/conversations/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "type": "one_to_one",
  "participants": [
    {
      "id": "string",
      "name": "string",
      "username": "string",
      "avatar_url": "https://example.com"
    }
  ],
  "last_message": "string",
  "last_sender_id": "string",
  "updated_at": "2026-10-13T09:00:00.000Z",
  "unread_count": 1,
  "message_count": 1,
  "messages": [
    {
      "id": "string",
      "text": "string",
      "direction": "in",
      "sent_at": "2026-10-13T09:00:00.000Z",
      "from_id": "string",
      "sender_username": "string",
      "sender_name": "string",
      "conversation_id": "string",
      "event_type": "MessageCreate",
      "attachments": [
        {
          "type": "string",
          "media_key": "string",
          "url": "https://example.com"
        }
      ]
    }
  ]
}
```

## X: Send message (Direct messages)

`POST /accounts/{accountId}/x/conversations/{itemId}/send`

Send message. DM conversations (legacy DM API). End-to-end encrypted X Chat threads are not readable here. Requires scopes: dm.read, users.read, tweet.read, dm.write. Network docs: https://docs.x.com/x-api/direct-messages/introduction Generic route: /v1/accounts/{accountId}/focus/conversations.

Access: `write` · MCP tool: `x-conversations-send` · Zernio: `DELETE /v1/inbox/conversations/{conversationId}/messages/{messageId}`

### 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; ≤ 10000 characters)
- `media` (string): One image, GIF or video

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/conversations/ITEM_ID/send" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string",
    "media": "string"
  }'
```

Response 200:

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

## X: Block DMs from participant (Direct messages)

`POST /accounts/{accountId}/x/conversations/{itemId}/block-dms`

Block DMs from participant. DM conversations (legacy DM API). End-to-end encrypted X Chat threads are not readable here. Requires scopes: dm.read, users.read, tweet.read, dm.write. Network docs: https://docs.x.com/x-api/direct-messages/introduction Generic route: /v1/accounts/{accountId}/focus/conversations.

Access: `write` · MCP tool: `x-conversations-block-dms`

### 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

- `user_id` (string; required)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/conversations/ITEM_ID/block-dms" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "string"
  }'
```

Response 200:

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

## X: List DM events

`GET /accounts/{accountId}/x/dm-events`

GET /2/dm_events. Raw DM event log: messages, joins and leaves across conversations. Cursor pagination: pass next_cursor back as cursor. Requires scopes: dm.read, users.read, tweet.read. Generic route: /v1/accounts/{accountId}/focus/dm-events.

Access: `read` · MCP tool: `x-dm-events-list`

### Path parameters

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

### Query parameters

- `cursor` (string): Pagination cursor (next_cursor)
- `limit` (integer; 1–100)
- `event_types` (array of string)

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "text": "string",
      "direction": "in",
      "sent_at": "2026-10-13T09:00:00.000Z",
      "from_id": "string",
      "sender_username": "string",
      "sender_name": "string",
      "conversation_id": "string",
      "event_type": "MessageCreate",
      "attachments": [
        {
          "type": "string",
          "media_key": "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"
}
```

## X: Create a DM events item

`POST /accounts/{accountId}/x/dm-events`

Send a DM to a participant or conversation. Raw DM event log: messages, joins and leaves across conversations. Requires scopes: dm.read, users.read, tweet.read, dm.write. Generic route: /v1/accounts/{accountId}/focus/dm-events.

Access: `write` · MCP tool: `x-dm-events-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

- `participant_id` (string)
- `conversation_id` (string)
- `text` (string; ≤ 10000 characters)
- `media` (string)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/dm-events" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "participant_id": "string",
    "conversation_id": "string",
    "text": "string",
    "media": "string"
  }'
```

Response 201:

```json
{
  "id": "string",
  "text": "string",
  "direction": "in",
  "sent_at": "2026-10-13T09:00:00.000Z",
  "from_id": "string",
  "sender_username": "string",
  "sender_name": "string",
  "conversation_id": "string",
  "event_type": "MessageCreate",
  "attachments": [
    {
      "type": "string",
      "media_key": "string",
      "url": "https://example.com"
    }
  ]
}
```

## X: Get a DM events item

`GET /accounts/{accountId}/x/dm-events/{itemId}`

GET /2/dm_events/:id. Raw DM event log: messages, joins and leaves across conversations. Requires scopes: dm.read, users.read, tweet.read. Generic route: /v1/accounts/{accountId}/focus/dm-events.

Access: `read` · MCP tool: `x-dm-events-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/x/dm-events/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "text": "string",
  "direction": "in",
  "sent_at": "2026-10-13T09:00:00.000Z",
  "from_id": "string",
  "sender_username": "string",
  "sender_name": "string",
  "conversation_id": "string",
  "event_type": "MessageCreate",
  "attachments": [
    {
      "type": "string",
      "media_key": "string",
      "url": "https://example.com"
    }
  ]
}
```

## X: Delete a DM events item

`DELETE /accounts/{accountId}/x/dm-events/{itemId}`

DELETE /2/dm_events/:id (for you only). Raw DM event log: messages, joins and leaves across conversations. Requires scopes: dm.read, users.read, tweet.read, dm.write. Generic route: /v1/accounts/{accountId}/focus/dm-events.

Access: `write` · MCP tool: `x-dm-events-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/x/dm-events/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

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

## X: List X Chat

`GET /accounts/{accountId}/x/chat-conversations`

GET /2/chat/conversations (or message requests). Encrypted X Chat conversations: metadata, read state, archive and mute. Message bodies are end-to-end encrypted and need the Chat XDK to decrypt. Cursor pagination: pass next_cursor back as cursor. Requires scopes: dm.read, users.read, tweet.read. Network docs: https://docs.x.com/x-api/chat/introduction Generic route: /v1/accounts/{accountId}/focus/chat-conversations.

Access: `read` · MCP tool: `x-chat-conversations-list`

### Path parameters

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

### Query parameters

- `cursor` (string): Pagination cursor (next_cursor)
- `limit` (integer; 1–100)
- `unread_only` (boolean)
- `folder` (string; one of inbox, requests)

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "type": "string",
      "group_name": "string",
      "participants": [
        {
          "id": "string",
          "username": "string",
          "name": "string"
        }
      ],
      "unread": true,
      "is_archived": true,
      "is_muted": true,
      "created_at": "2026-10-13T09:00:00.000Z",
      "updated_at": "2026-10-13T09:00:00.000Z",
      "newest_event_id": "string",
      "message_ttl_ms": 1
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## X: Get a X Chat item

`GET /accounts/{accountId}/x/chat-conversations/{itemId}`

GET /2/chat/conversations/:id. Encrypted X Chat conversations: metadata, read state, archive and mute. Message bodies are end-to-end encrypted and need the Chat XDK to decrypt. Requires scopes: dm.read, users.read, tweet.read. Network docs: https://docs.x.com/x-api/chat/introduction Generic route: /v1/accounts/{accountId}/focus/chat-conversations.

Access: `read` · MCP tool: `x-chat-conversations-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/x/chat-conversations/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "type": "string",
  "group_name": "string",
  "participants": [
    {
      "id": "string",
      "username": "string",
      "name": "string"
    }
  ],
  "unread": true,
  "is_archived": true,
  "is_muted": true,
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z",
  "newest_event_id": "string",
  "message_ttl_ms": 1
}
```

## X: Mark read (X Chat)

`POST /accounts/{accountId}/x/chat-conversations/{itemId}/mark-read`

Mark read. Encrypted X Chat conversations: metadata, read state, archive and mute. Message bodies are end-to-end encrypted and need the Chat XDK to decrypt. Requires scopes: dm.read, users.read, tweet.read, dm.write. Network docs: https://docs.x.com/x-api/chat/introduction Generic route: /v1/accounts/{accountId}/focus/chat-conversations.

Access: `write` · MCP tool: `x-chat-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/x/chat-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
}
```

## X: Mark unread (X Chat)

`POST /accounts/{accountId}/x/chat-conversations/{itemId}/mark-unread`

Mark unread. Encrypted X Chat conversations: metadata, read state, archive and mute. Message bodies are end-to-end encrypted and need the Chat XDK to decrypt. Requires scopes: dm.read, users.read, tweet.read, dm.write. Network docs: https://docs.x.com/x-api/chat/introduction Generic route: /v1/accounts/{accountId}/focus/chat-conversations.

Access: `write` · MCP tool: `x-chat-conversations-mark-unread`

### 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/x/chat-conversations/ITEM_ID/mark-unread" \
  -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
}
```

## X: Archive (X Chat)

`POST /accounts/{accountId}/x/chat-conversations/{itemId}/archive`

Archive. Encrypted X Chat conversations: metadata, read state, archive and mute. Message bodies are end-to-end encrypted and need the Chat XDK to decrypt. Requires scopes: dm.read, users.read, tweet.read, dm.write. Network docs: https://docs.x.com/x-api/chat/introduction Generic route: /v1/accounts/{accountId}/focus/chat-conversations.

Access: `write` · MCP tool: `x-chat-conversations-archive`

### 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/x/chat-conversations/ITEM_ID/archive" \
  -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
}
```

## X: Unarchive (X Chat)

`POST /accounts/{accountId}/x/chat-conversations/{itemId}/unarchive`

Unarchive. Encrypted X Chat conversations: metadata, read state, archive and mute. Message bodies are end-to-end encrypted and need the Chat XDK to decrypt. Requires scopes: dm.read, users.read, tweet.read, dm.write. Network docs: https://docs.x.com/x-api/chat/introduction Generic route: /v1/accounts/{accountId}/focus/chat-conversations.

Access: `write` · MCP tool: `x-chat-conversations-unarchive`

### 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/x/chat-conversations/ITEM_ID/unarchive" \
  -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
}
```

## X: Mute (X Chat)

`POST /accounts/{accountId}/x/chat-conversations/{itemId}/mute`

Mute. Encrypted X Chat conversations: metadata, read state, archive and mute. Message bodies are end-to-end encrypted and need the Chat XDK to decrypt. Requires scopes: dm.read, users.read, tweet.read, dm.write. Network docs: https://docs.x.com/x-api/chat/introduction Generic route: /v1/accounts/{accountId}/focus/chat-conversations.

Access: `write` · MCP tool: `x-chat-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/x/chat-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
}
```

## X: Unmute (X Chat)

`POST /accounts/{accountId}/x/chat-conversations/{itemId}/unmute`

Unmute. Encrypted X Chat conversations: metadata, read state, archive and mute. Message bodies are end-to-end encrypted and need the Chat XDK to decrypt. Requires scopes: dm.read, users.read, tweet.read, dm.write. Network docs: https://docs.x.com/x-api/chat/introduction Generic route: /v1/accounts/{accountId}/focus/chat-conversations.

Access: `write` · MCP tool: `x-chat-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/x/chat-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
}
```

## X: Accept message request (X Chat)

`POST /accounts/{accountId}/x/chat-conversations/{itemId}/accept`

Accept message request. Encrypted X Chat conversations: metadata, read state, archive and mute. Message bodies are end-to-end encrypted and need the Chat XDK to decrypt. Requires scopes: dm.read, users.read, tweet.read, dm.write. Network docs: https://docs.x.com/x-api/chat/introduction Generic route: /v1/accounts/{accountId}/focus/chat-conversations.

Access: `write` · MCP tool: `x-chat-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/x/chat-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
}
```

## X: List Post volume

`GET /accounts/{accountId}/x/post-counts`

GET /2/tweets/counts/recent ($0.005 per request). How many posts match a query over the last 7 days (per minute, hour or day). Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read. Generic route: /v1/accounts/{accountId}/focus/post-counts.

Access: `read` · MCP tool: `x-post-counts-list`

### Path parameters

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

### Query parameters

- `q` (string; required)
- `granularity` (string; one of minute, hour, day)
- `start_time` (string (date-time))
- `end_time` (string (date-time))

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "date": "2026-10-13T09:00:00.000Z",
      "end": "2026-10-13T09:00:00.000Z",
      "posts": 1
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## X: List Trends

`GET /accounts/{accountId}/x/trends`

GET /2/users/personalized_trends | /2/trends/by/woeid/:woeid ($0.010 per request). Trends personalized for the account, or for a location (WOEID). Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read, users.read. Generic route: /v1/accounts/{accountId}/focus/trends.

Access: `read` · MCP tool: `x-trends-list`

### Path parameters

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

### Query parameters

- `woeid` (integer): Yahoo WOEID (1 = worldwide). Omit for personalized trends.
- `limit` (integer; 1–50)

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "trend_name": "string",
      "post_count": "string",
      "category": "string",
      "trending_since": "string",
      "search_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"
}
```

## X: List News

`GET /accounts/{accountId}/x/news`

GET /2/news/search. X News stories (Grok-summarized clusters of posts). Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read, users.read. Generic route: /v1/accounts/{accountId}/focus/news.

Access: `read` · MCP tool: `x-news-list`

### Path parameters

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

### Query parameters

- `q` (string; required)
- `max_age_hours` (integer; 1–720)
- `limit` (integer; 1–100)

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "summary": "string",
      "hook": "string",
      "category": "string",
      "keywords": [
        "string"
      ],
      "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"
}
```

## X: Get a News item

`GET /accounts/{accountId}/x/news/{itemId}`

GET /2/news/:id. X News stories (Grok-summarized clusters of posts). Requires scopes: tweet.read, users.read. Generic route: /v1/accounts/{accountId}/focus/news.

Access: `read` · MCP tool: `x-news-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/x/news/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "name": "string",
  "summary": "string",
  "hook": "string",
  "category": "string",
  "keywords": [
    "string"
  ],
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## X: List Communities

`GET /accounts/{accountId}/x/communities`

GET /2/communities/search. Find X Communities and post into them. Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read, users.read. Network docs: https://docs.x.com/x-api/communities/lookup/introduction Generic route: /v1/accounts/{accountId}/focus/communities.

Access: `read` · MCP tool: `x-communities-list`

### Path parameters

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

### Query parameters

- `q` (string; required)
- `cursor` (string)
- `limit` (integer; 10–100)

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "description": "string",
      "access": "string",
      "join_policy": "string",
      "member_count": 1,
      "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"
}
```

## X: Get a Communities item

`GET /accounts/{accountId}/x/communities/{itemId}`

GET /2/communities/:id. Find X Communities and post into them. Requires scopes: tweet.read, users.read, list.read. Network docs: https://docs.x.com/x-api/communities/lookup/introduction Generic route: /v1/accounts/{accountId}/focus/communities.

Access: `read` · MCP tool: `x-communities-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/x/communities/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "name": "string",
  "description": "string",
  "access": "string",
  "join_policy": "string",
  "member_count": 1,
  "created_at": "2026-10-13T09:00:00.000Z",
  "url": "https://example.com"
}
```

## X: Post to community (Communities)

`POST /accounts/{accountId}/x/communities/{itemId}/post`

Post to community. Find X Communities and post into them. Requires scopes: tweet.read, users.read, tweet.write. Network docs: https://docs.x.com/x-api/communities/lookup/introduction Generic route: /v1/accounts/{accountId}/focus/communities.

Access: `write` · MCP tool: `x-communities-post`

### 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)
- `media` (array of string; ≤ 4 items)
- `share_with_followers` (boolean)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/communities/ITEM_ID/post" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string",
    "media": [
      "string"
    ],
    "share_with_followers": true
  }'
```

Response 200:

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

## X: List Spaces

`GET /accounts/{accountId}/x/spaces`

GET /2/spaces/by/creator_ids (mine) | /2/spaces/search. Your live and scheduled Spaces, or search Spaces. Spaces cannot be created through the API. Cursor pagination: pass next_cursor back as cursor. Requires scopes: space.read, users.read, tweet.read. Network docs: https://docs.x.com/x-api/spaces/introduction Generic route: /v1/accounts/{accountId}/focus/spaces.

Access: `read` · MCP tool: `x-spaces-list`

### Path parameters

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

### Query parameters

- `q` (string): Search Spaces; omit for your own
- `state` (string; one of live, scheduled, all)
- `creator_ids` (string)
- `limit` (integer; 1–100)

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "title": "string",
      "state": "live",
      "lang": "string",
      "is_ticketed": true,
      "participant_count": 1,
      "subscriber_count": 1,
      "scheduled_start": "2026-10-13T09:00:00.000Z",
      "started_at": "2026-10-13T09:00:00.000Z",
      "ended_at": "2026-10-13T09:00:00.000Z",
      "creator_id": "string",
      "creator_username": "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"
}
```

## X: Get a Spaces item

`GET /accounts/{accountId}/x/spaces/{itemId}`

GET /2/spaces/:id. Your live and scheduled Spaces, or search Spaces. Spaces cannot be created through the API. Requires scopes: space.read, users.read, tweet.read. Network docs: https://docs.x.com/x-api/spaces/introduction Generic route: /v1/accounts/{accountId}/focus/spaces.

Access: `read` · MCP tool: `x-spaces-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/x/spaces/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "title": "string",
  "state": "live",
  "lang": "string",
  "is_ticketed": true,
  "participant_count": 1,
  "subscriber_count": 1,
  "scheduled_start": "2026-10-13T09:00:00.000Z",
  "started_at": "2026-10-13T09:00:00.000Z",
  "ended_at": "2026-10-13T09:00:00.000Z",
  "creator_id": "string",
  "creator_username": "string",
  "url": "https://example.com"
}
```

## X: List Space posts

`GET /accounts/{accountId}/x/space-posts`

GET /2/spaces/:id/tweets. Posts shared in a Space. Cursor pagination: pass next_cursor back as cursor. Requires scopes: space.read, users.read, tweet.read. Generic route: /v1/accounts/{accountId}/focus/space-posts.

Access: `read` · MCP tool: `x-space-posts-list`

### Path parameters

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

### Query parameters

- `cursor` (string): Pagination cursor (next_cursor)
- `limit` (integer; 1–100)
- `space_id` (string; required)

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "text": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "url": "https://example.com",
      "kind": "post",
      "author_id": "string",
      "author_username": "string",
      "author_name": "string",
      "author_avatar_url": "https://example.com",
      "conversation_id": "string",
      "in_reply_to_user_id": "string",
      "reply_to_id": "string",
      "quoted_id": "string",
      "reposted_id": "string",
      "lang": "string",
      "reply_settings": "everyone",
      "community_id": "string",
      "possibly_sensitive": true,
      "paid_partnership": true,
      "editable_until": "2026-10-13T09:00:00.000Z",
      "edits_remaining": 1,
      "media": [
        {
          "media_key": "string",
          "type": "photo",
          "url": "https://example.com",
          "preview_image_url": "https://example.com",
          "width": 1,
          "height": 1
        }
      ],
      "poll": {
        "id": "string",
        "options": [
          {
            "position": null,
            "label": null,
            "votes": null
          }
        ],
        "total_votes": 1,
        "voting_status": "open",
        "end_datetime": "2026-10-13T09:00:00.000Z",
        "duration_minutes": 1
      },
      "likes": 1,
      "reposts": 1,
      "replies": 1,
      "quotes": 1,
      "bookmarks": 1,
      "impressions": 1
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## X: List Ticket buyers

`GET /accounts/{accountId}/x/space-buyers`

GET /2/spaces/:id/buyers. Accounts that bought a ticket to your ticketed Space. Cursor pagination: pass next_cursor back as cursor. Requires scopes: space.read, users.read, tweet.read. Generic route: /v1/accounts/{accountId}/focus/space-buyers.

Access: `read` · MCP tool: `x-space-buyers-list`

### Path parameters

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

### Query parameters

- `cursor` (string): Pagination cursor (next_cursor)
- `limit` (integer; 1–100)
- `space_id` (string; required)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/space-buyers?space_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "username": "string",
      "name": "string",
      "url": "https://example.com",
      "avatar_url": "https://example.com",
      "description": "string",
      "location": "string",
      "website": "https://example.com",
      "created_at": "2026-10-13T09:00:00.000Z",
      "protected": true,
      "verified": true,
      "verified_type": "blue",
      "followers": 1,
      "following": 1,
      "posts": 1,
      "listed": 1,
      "likes": 1,
      "media_count": 1
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## X: List Broadcasts

`GET /accounts/{accountId}/x/broadcasts`

GET /2/broadcasts. Your X Live broadcasts: live, ended and replays with viewer counts. Cursor pagination: pass next_cursor back as cursor. Requires scopes: broadcast.read. Network docs: https://docs.x.com/x-api/broadcasts/introduction Generic route: /v1/accounts/{accountId}/focus/broadcasts.

Access: `read` · MCP tool: `x-broadcasts-list`

### Path parameters

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

### Query parameters

- `cursor` (string): Pagination cursor (next_cursor)
- `limit` (integer; 1–100)
- `ids` (string): Comma-separated broadcast ids

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "title": "string",
      "state": "string",
      "share_url": "https://example.com",
      "image_url": "https://example.com",
      "post_id": "string",
      "chat_option": 1,
      "available_for_replay": true,
      "language": "en",
      "started_at": "2026-10-13T09:00:00.000Z",
      "ended_at": "2026-10-13T09:00:00.000Z",
      "scheduled_start": "2026-10-13T09:00:00.000Z",
      "scheduled_end": "2026-10-13T09:00:00.000Z",
      "watching": 1,
      "watched": 1
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## X: Get a Broadcasts item

`GET /accounts/{accountId}/x/broadcasts/{itemId}`

GET /2/broadcasts/:id. Your X Live broadcasts: live, ended and replays with viewer counts. Requires scopes: broadcast.read. Network docs: https://docs.x.com/x-api/broadcasts/introduction Generic route: /v1/accounts/{accountId}/focus/broadcasts.

Access: `read` · MCP tool: `x-broadcasts-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/x/broadcasts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "title": "string",
  "state": "string",
  "share_url": "https://example.com",
  "image_url": "https://example.com",
  "post_id": "string",
  "chat_option": 1,
  "available_for_replay": true,
  "language": "en",
  "started_at": "2026-10-13T09:00:00.000Z",
  "ended_at": "2026-10-13T09:00:00.000Z",
  "scheduled_start": "2026-10-13T09:00:00.000Z",
  "scheduled_end": "2026-10-13T09:00:00.000Z",
  "watching": 1,
  "watched": 1
}
```

## X: List Scheduled broadcasts

`GET /accounts/{accountId}/x/scheduled-broadcasts`

GET /2/broadcasts/scheduled. Schedule X Live broadcasts (one-off or recurring), edit them and go live. Cursor pagination: pass next_cursor back as cursor. Requires scopes: broadcast.read. Generic route: /v1/accounts/{accountId}/focus/scheduled-broadcasts.

Access: `read` · MCP tool: `x-scheduled-broadcasts-list`

### Path parameters

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

### Query parameters

- `cursor` (string): Pagination cursor (next_cursor)
- `limit` (integer; 1–100)
- `oldest_start_time` (string (date-time))
- `newest_start_time` (string (date-time))

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "broadcast_id": "string",
      "title": "string",
      "description": "string",
      "state": "string",
      "source_id": "string",
      "scheduled_start": "2026-10-13T09:00:00.000Z",
      "scheduled_end": "2026-10-13T09:00:00.000Z",
      "chat_option": "0",
      "available_for_replay": true,
      "manual_publish": true,
      "locale": "en",
      "recurring_schedule_id": "string",
      "thumbnail_media_id": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## X: Create a Scheduled broadcasts item

`POST /accounts/{accountId}/x/scheduled-broadcasts`

POST /2/broadcasts/scheduled. Schedule X Live broadcasts (one-off or recurring), edit them and go live. Requires scopes: broadcast.read, broadcast.write. Generic route: /v1/accounts/{accountId}/focus/scheduled-broadcasts.

Access: `write` · MCP tool: `x-scheduled-broadcasts-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

- `title` (string)
- `description` (string)
- `source_id` (string; required): Ingest source id (RTMP stream key)
- `scheduled_start` (string (date-time); required)
- `scheduled_end` (string (date-time))
- `chat_option` (string; one of 0, 1, 2, 3, 4, 5, 6): Who can chat: 0 default, 1 off, 2 everyone, 3 verified, 4 accounts the host follows, 5 subscribers, 6 followed-by-followed
- `available_for_replay` (boolean)
- `manual_publish` (boolean): Do not auto-publish at start; call go-live
- `is_locked` (boolean)
- `locale` (string)
- `thumbnail_media_id` (string)
- `recurrence` (object)
  - `recurrence.frequency` (string; one of Daily, Weekly)
  - `recurrence.repeats` (integer; ≥ 1)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/scheduled-broadcasts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "string",
    "description": "string",
    "source_id": "string",
    "scheduled_start": "2026-10-13T09:00:00.000Z",
    "scheduled_end": "2026-10-13T09:00:00.000Z"
  }'
```

Response 201:

```json
{
  "id": "string",
  "broadcast_id": "string",
  "title": "string",
  "description": "string",
  "state": "string",
  "source_id": "string",
  "scheduled_start": "2026-10-13T09:00:00.000Z",
  "scheduled_end": "2026-10-13T09:00:00.000Z",
  "chat_option": "0",
  "available_for_replay": true,
  "manual_publish": true,
  "locale": "en",
  "recurring_schedule_id": "string",
  "thumbnail_media_id": "string"
}
```

## X: Get a Scheduled broadcasts item

`GET /accounts/{accountId}/x/scheduled-broadcasts/{itemId}`

GET /2/broadcasts/scheduled/:id. Schedule X Live broadcasts (one-off or recurring), edit them and go live. Requires scopes: broadcast.read. Generic route: /v1/accounts/{accountId}/focus/scheduled-broadcasts.

Access: `read` · MCP tool: `x-scheduled-broadcasts-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/x/scheduled-broadcasts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "broadcast_id": "string",
  "title": "string",
  "description": "string",
  "state": "string",
  "source_id": "string",
  "scheduled_start": "2026-10-13T09:00:00.000Z",
  "scheduled_end": "2026-10-13T09:00:00.000Z",
  "chat_option": "0",
  "available_for_replay": true,
  "manual_publish": true,
  "locale": "en",
  "recurring_schedule_id": "string",
  "thumbnail_media_id": "string"
}
```

## X: Update a Scheduled broadcasts item

`PATCH /accounts/{accountId}/x/scheduled-broadcasts/{itemId}`

PUT /2/broadcasts/scheduled/:id (start and end are required by X; missing ones are read back first). Schedule X Live broadcasts (one-off or recurring), edit them and go live. Requires scopes: broadcast.read, broadcast.write. Generic route: /v1/accounts/{accountId}/focus/scheduled-broadcasts.

Access: `write` · MCP tool: `x-scheduled-broadcasts-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

- `title` (string)
- `description` (string)
- `source_id` (string): Ingest source id (RTMP stream key)
- `scheduled_start` (string (date-time))
- `scheduled_end` (string (date-time))
- `chat_option` (string; one of 0, 1, 2, 3, 4, 5, 6): Who can chat: 0 default, 1 off, 2 everyone, 3 verified, 4 accounts the host follows, 5 subscribers, 6 followed-by-followed
- `available_for_replay` (boolean)
- `manual_publish` (boolean): Do not auto-publish at start; call go-live
- `is_locked` (boolean)
- `locale` (string)
- `thumbnail_media_id` (string)
- `recurrence` (object)
  - `recurrence.frequency` (string; one of Daily, Weekly)
  - `recurrence.repeats` (integer; ≥ 1)
- `roll_forward` (boolean)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/scheduled-broadcasts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "string",
    "description": "string",
    "source_id": "string",
    "scheduled_start": "2026-10-13T09:00:00.000Z",
    "scheduled_end": "2026-10-13T09:00:00.000Z"
  }'
```

Response 200:

```json
{
  "id": "string",
  "broadcast_id": "string",
  "title": "string",
  "description": "string",
  "state": "string",
  "source_id": "string",
  "scheduled_start": "2026-10-13T09:00:00.000Z",
  "scheduled_end": "2026-10-13T09:00:00.000Z",
  "chat_option": "0",
  "available_for_replay": true,
  "manual_publish": true,
  "locale": "en",
  "recurring_schedule_id": "string",
  "thumbnail_media_id": "string"
}
```

## X: Delete a Scheduled broadcasts item

`DELETE /accounts/{accountId}/x/scheduled-broadcasts/{itemId}`

DELETE /2/broadcasts/scheduled/:id. Schedule X Live broadcasts (one-off or recurring), edit them and go live. Requires scopes: broadcast.read, broadcast.write. Generic route: /v1/accounts/{accountId}/focus/scheduled-broadcasts.

Access: `write` · MCP tool: `x-scheduled-broadcasts-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/x/scheduled-broadcasts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

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

## X: Go live (Scheduled broadcasts)

`POST /accounts/{accountId}/x/scheduled-broadcasts/{itemId}/go-live`

POST /2/broadcasts/scheduled/:id/live (for manual_publish broadcasts). Schedule X Live broadcasts (one-off or recurring), edit them and go live. Requires scopes: broadcast.read, broadcast.write. Generic route: /v1/accounts/{accountId}/focus/scheduled-broadcasts.

Access: `write` · MCP tool: `x-scheduled-broadcasts-go-live`

### 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/x/scheduled-broadcasts/ITEM_ID/go-live" \
  -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
}
```

## X: List Live chat

`GET /accounts/{accountId}/x/broadcast-chat`

GET /2/broadcasts/:id/chat (item id = "<broadcast_id>:<message_id>"). Read and moderate a broadcast chat: send, remove messages, mute or time out viewers. Cursor pagination: pass next_cursor back as cursor. Requires scopes: broadcast.read. Generic route: /v1/accounts/{accountId}/focus/broadcast-chat.

Access: `read` · MCP tool: `x-broadcast-chat-list`

### Path parameters

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

### Query parameters

- `cursor` (string): Pagination cursor (next_cursor)
- `limit` (integer; 1–200)
- `broadcast_id` (string; required)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/broadcast-chat?broadcast_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "message_id": "string",
      "broadcast_id": "string",
      "text": "string",
      "author_id": "string",
      "author_username": "string",
      "author_name": "string",
      "reply_to": "+15551234567",
      "created_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"
}
```

## X: Create a Live chat item

`POST /accounts/{accountId}/x/broadcast-chat`

POST /2/broadcasts/:id/chat. Read and moderate a broadcast chat: send, remove messages, mute or time out viewers. Requires scopes: broadcast.read, broadcast.write. Generic route: /v1/accounts/{accountId}/focus/broadcast-chat.

Access: `write` · MCP tool: `x-broadcast-chat-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

- `broadcast_id` (string; required)
- `text` (string; required; ≤ 140 characters)
- `reply_to` (string)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/broadcast-chat" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "broadcast_id": "string",
    "text": "string",
    "reply_to": "+15551234567"
  }'
```

Response 201:

```json
{
  "id": "string",
  "message_id": "string",
  "broadcast_id": "string",
  "text": "string",
  "author_id": "string",
  "author_username": "string",
  "author_name": "string",
  "reply_to": "+15551234567",
  "created_at": "2026-10-13T09:00:00.000Z"
}
```

## X: Delete a Live chat item

`DELETE /accounts/{accountId}/x/broadcast-chat/{itemId}`

DELETE /2/broadcasts/:id/chat/:message_id. Read and moderate a broadcast chat: send, remove messages, mute or time out viewers. Requires scopes: broadcast.read, broadcast.write. Generic route: /v1/accounts/{accountId}/focus/broadcast-chat.

Access: `write` · MCP tool: `x-broadcast-chat-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/x/broadcast-chat/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

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

## X: Mute author (Live chat)

`POST /accounts/{accountId}/x/broadcast-chat/{itemId}/mute-author`

Mute author. Read and moderate a broadcast chat: send, remove messages, mute or time out viewers. Requires scopes: broadcast.read, broadcast.write. Generic route: /v1/accounts/{accountId}/focus/broadcast-chat.

Access: `write` · MCP tool: `x-broadcast-chat-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.

### Body

- `minutes` (integer; ≥ 1): Omit to mute for the whole broadcast
- `remove_message` (boolean)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/broadcast-chat/ITEM_ID/mute-author" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "minutes": 1,
    "remove_message": true
  }'
```

Response 200:

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

## X: Mute user (Live chat)

`POST /accounts/{accountId}/x/broadcast-chat/mute-user`

Mute user. Read and moderate a broadcast chat: send, remove messages, mute or time out viewers. Requires scopes: broadcast.read, broadcast.write. Generic route: /v1/accounts/{accountId}/focus/broadcast-chat.

Access: `write` · MCP tool: `x-broadcast-chat-mute-user`

### 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

- `broadcast_id` (string; required)
- `user_id` (string; required)
- `minutes` (integer; ≥ 1)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/broadcast-chat/mute-user" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "broadcast_id": "string",
    "user_id": "string",
    "minutes": 1
  }'
```

Response 200:

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

## X: Unmute user (Live chat)

`POST /accounts/{accountId}/x/broadcast-chat/unmute-user`

Unmute user. Read and moderate a broadcast chat: send, remove messages, mute or time out viewers. Requires scopes: broadcast.read, broadcast.write. Generic route: /v1/accounts/{accountId}/focus/broadcast-chat.

Access: `write` · MCP tool: `x-broadcast-chat-unmute-user`

### 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

- `broadcast_id` (string; required)
- `user_id` (string; required)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/broadcast-chat/unmute-user" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "broadcast_id": "string",
    "user_id": "string"
  }'
```

Response 200:

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

## X: List Chat moderators

`GET /accounts/{accountId}/x/broadcast-moderators`

GET /2/broadcasts/chat/moderators. Accounts allowed to moderate your live chats. Cursor pagination: pass next_cursor back as cursor. Requires scopes: broadcast.read, users.read, tweet.read. Generic route: /v1/accounts/{accountId}/focus/broadcast-moderators.

Access: `read` · MCP tool: `x-broadcast-moderators-list`

### Path parameters

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

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "username": "string",
      "name": "string",
      "url": "https://example.com",
      "avatar_url": "https://example.com",
      "description": "string",
      "location": "string",
      "website": "https://example.com",
      "created_at": "2026-10-13T09:00:00.000Z",
      "protected": true,
      "verified": true,
      "verified_type": "blue",
      "followers": 1,
      "following": 1,
      "posts": 1,
      "listed": 1,
      "likes": 1,
      "media_count": 1
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## X: Create a Chat moderators item

`POST /accounts/{accountId}/x/broadcast-moderators`

POST /2/broadcasts/chat/moderators. Accounts allowed to moderate your live chats. Requires scopes: broadcast.read, users.read, tweet.read, broadcast.write. Generic route: /v1/accounts/{accountId}/focus/broadcast-moderators.

Access: `write` · MCP tool: `x-broadcast-moderators-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

- `user_id` (string; required)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/broadcast-moderators" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "string"
  }'
```

Response 201:

```json
{
  "id": "string",
  "username": "string",
  "name": "string",
  "url": "https://example.com",
  "avatar_url": "https://example.com",
  "description": "string",
  "location": "string",
  "website": "https://example.com",
  "created_at": "2026-10-13T09:00:00.000Z",
  "protected": true,
  "verified": true,
  "verified_type": "blue",
  "followers": 1,
  "following": 1,
  "posts": 1,
  "listed": 1,
  "likes": 1,
  "media_count": 1
}
```

## X: Delete a Chat moderators item

`DELETE /accounts/{accountId}/x/broadcast-moderators/{itemId}`

DELETE /2/broadcasts/chat/moderators/:user_id. Accounts allowed to moderate your live chats. Requires scopes: broadcast.read, users.read, tweet.read, broadcast.write. Generic route: /v1/accounts/{accountId}/focus/broadcast-moderators.

Access: `write` · MCP tool: `x-broadcast-moderators-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/x/broadcast-moderators/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

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

## X: Get Overview

`GET /accounts/{accountId}/x/account-overview`

GET /2/users/:id + GET /2/users/:id/tweets in the period. Followers and daily engagement aggregated from your posts in the period. Requires scopes: tweet.read, users.read. Generic route: /v1/accounts/{accountId}/focus/account-overview.

Access: `read` · MCP tool: `x-account-overview-get` · Zernio: `GET /v1/accounts/follower-stats`

### Path parameters

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

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

Response 200:

```json
{
  "followers": 1,
  "following": 1,
  "posts_count": 1,
  "listed_count": 1,
  "likes_count": 1,
  "media_count": 1,
  "totals": {
    "impressions": 1,
    "likes": 1,
    "comments": 1,
    "shares": 1,
    "quotes": 1,
    "saves": 1,
    "clicks": 1,
    "profile_views": 1,
    "views": 1,
    "engagements": 1,
    "engagement_rate": 1.5
  },
  "series": [
    {
      "date": "2026-10-13",
      "metrics": {
        "impressions": 1,
        "likes": 1,
        "comments": 1,
        "shares": 1,
        "quotes": 1,
        "saves": 1
      }
    }
  ],
  "posts_analyzed": 1
}
```

## X: List Post performance

`GET /accounts/{accountId}/x/post-metrics`

Recent posts (or ids) with public + non-public metrics. Per-post impressions, engagements, link and profile clicks (non-public metrics for posts under 30 days). Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read, users.read. Network docs: https://docs.x.com/x-api/fundamentals/metrics Generic route: /v1/accounts/{accountId}/focus/post-metrics.

Access: `read` · MCP tool: `x-post-metrics-list` · Zernio: `GET /v1/analytics`

### Path parameters

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

### Query parameters

- `ids` (string): Comma-separated post ids; omit for your recent posts
- `limit` (integer; 5–100)

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "text": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "url": "https://example.com",
      "metrics": {
        "impressions": 1,
        "likes": 1,
        "comments": 1,
        "shares": 1,
        "quotes": 1,
        "saves": 1
      }
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## X: List Post analytics (Enterprise)

`GET /accounts/{accountId}/x/post-analytics`

GET /2/tweets/analytics. Hourly/daily/weekly time series for up to 100 posts. Requires an X Enterprise contract. Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read, users.read. Network docs: https://docs.x.com/x-api/posts/get-post-analytics Generic route: /v1/accounts/{accountId}/focus/post-analytics.

Access: `read` · MCP tool: `x-post-analytics-list`

### Path parameters

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

### Query parameters

- `ids` (string; required): Comma-separated post ids (≤100)
- `since` (string (date-time))
- `until` (string (date-time))
- `granularity` (string; one of hourly, daily, weekly, total)

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "metrics": {
        "impressions": 1,
        "likes": 1,
        "comments": 1,
        "shares": 1,
        "quotes": 1,
        "saves": 1
      },
      "series": [
        {
          "date": "2026-10-13",
          "metrics": {
            "impressions": null,
            "likes": null,
            "comments": null,
            "shares": null,
            "quotes": null,
            "saves": null
          }
        }
      ]
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## X: List Video analytics (Enterprise)

`GET /accounts/{accountId}/x/media-analytics`

GET /2/media/analytics. Video views, playback quartiles and watch time. Requires an X Enterprise contract. Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read. Generic route: /v1/accounts/{accountId}/focus/media-analytics.

Access: `read` · MCP tool: `x-media-analytics-list`

### Path parameters

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

### Query parameters

- `media_keys` (string; required)
- `since` (string (date-time))
- `until` (string (date-time))
- `granularity` (string; one of hourly, daily, total)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/media-analytics?media_keys=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "media_key": "string",
      "video_views": 1,
      "playback_start": 1,
      "playback25": 1,
      "playback50": 1,
      "playback75": 1,
      "playback_complete": 1,
      "watch_time_ms": 1
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## X: Get API usage

`GET /accounts/{accountId}/x/usage`

GET /2/usage/credits + GET /2/usage/tweets (app bearer). X developer-account credit balance and daily post consumption against the monthly cap. Generic route: /v1/accounts/{accountId}/focus/usage.

Access: `read` · MCP tool: `x-usage-get`

### Path parameters

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

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

Response 200:

```json
{
  "total_balance": 1.5,
  "prepaid_balance": 1.5,
  "free_balance": 1.5,
  "project_cap": 1,
  "project_usage": 1,
  "cap_reset_day": 1,
  "series": [
    {
      "date": "2026-10-13",
      "metrics": {
        "posts": 1
      }
    }
  ]
}
```


---

Source: https://socialit.com/docs/api-reference/focus-x/
