# Focus · Reddit API

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

## Reddit: Get Profile

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

GET /api/v1/me. Your Reddit account: karma, followers, account age and inbox state. Requires scopes: identity. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/profile.

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

### Path parameters

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

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

Response 200:

```json
{
  "id": "string",
  "username": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "link_karma": 1,
  "comment_karma": 1,
  "total_karma": 1,
  "awarder_karma": 1,
  "awardee_karma": 1,
  "icon_url": "https://example.com",
  "snoovatar_url": "https://example.com",
  "followers": 1,
  "profile_title": "string",
  "profile_description": "string",
  "over_18": true,
  "is_mod": true,
  "has_verified_email": true,
  "is_suspended": true,
  "accept_followers": true,
  "inbox_count": 1,
  "has_mail": true,
  "has_mod_mail": true
}
```

## Reddit: Get Preferences

`GET /accounts/{accountId}/reddit/preferences`

GET /api/v1/me/prefs. Account preferences (privacy, content, messaging). Email and password are never exposed. Requires scopes: identity. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/preferences.

Access: `read` · MCP tool: `reddit-preferences-get`

### Path parameters

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

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

Response 200:

```json
{
  "lang": "string",
  "over_18": true,
  "search_include_over_18": true,
  "label_nsfw": true,
  "hide_from_robots": true,
  "show_presence": true,
  "enable_followers": true,
  "accept_pms": "everyone",
  "show_location_based_recommendations": true,
  "activity_relevant_ads": true,
  "third_party_data_personalized_ads": true,
  "third_party_site_data_personalized_ads": true,
  "third_party_site_data_personalized_content": true,
  "allow_clicktracking": true,
  "media": "on",
  "media_preview": "on",
  "nightmode": true,
  "default_comment_sort": "confidence",
  "ignore_suggested_sort": true,
  "send_welcome_messages": true,
  "email_messages": true,
  "email_unsubscribe_all": true,
  "feed_recommendations_enabled": true,
  "top_karma_subreddits": true
}
```

## Reddit: Update Preferences

`PATCH /accounts/{accountId}/reddit/preferences`

PATCH /api/v1/me/prefs. Account preferences (privacy, content, messaging). Email and password are never exposed. Requires scopes: identity, account. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/preferences.

Access: `write` · MCP tool: `reddit-preferences-update`

### Path parameters

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

### Body

- `lang` (string): Interface language (e.g. en)
- `over_18` (boolean): I am over 18 and willing to view adult content
- `search_include_over_18` (boolean)
- `label_nsfw` (boolean)
- `hide_from_robots` (boolean): Hide profile from search engines
- `show_presence` (boolean): Show online status
- `enable_followers` (boolean): Allow people to follow you
- `accept_pms` (string; one of everyone, whitelisted)
- `show_location_based_recommendations` (boolean)
- `activity_relevant_ads` (boolean)
- `third_party_data_personalized_ads` (boolean)
- `third_party_site_data_personalized_ads` (boolean)
- `third_party_site_data_personalized_content` (boolean)
- `allow_clicktracking` (boolean)
- `media` (string; one of on, off, subreddit)
- `media_preview` (string; one of on, off, subreddit)
- `nightmode` (boolean)
- `default_comment_sort` (string; one of confidence, top, new, controversial, old, random, qa, live)
- `ignore_suggested_sort` (boolean)
- `send_welcome_messages` (boolean)
- `email_messages` (boolean)
- `email_unsubscribe_all` (boolean)
- `feed_recommendations_enabled` (boolean)
- `top_karma_subreddits` (boolean)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/preferences" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "lang": "string",
    "over_18": true,
    "search_include_over_18": true,
    "label_nsfw": true,
    "hide_from_robots": true
  }'
```

Response 200:

```json
{
  "lang": "string",
  "over_18": true,
  "search_include_over_18": true,
  "label_nsfw": true,
  "hide_from_robots": true,
  "show_presence": true,
  "enable_followers": true,
  "accept_pms": "everyone",
  "show_location_based_recommendations": true,
  "activity_relevant_ads": true,
  "third_party_data_personalized_ads": true,
  "third_party_site_data_personalized_ads": true,
  "third_party_site_data_personalized_content": true,
  "allow_clicktracking": true,
  "media": "on",
  "media_preview": "on",
  "nightmode": true,
  "default_comment_sort": "confidence",
  "ignore_suggested_sort": true,
  "send_welcome_messages": true,
  "email_messages": true,
  "email_unsubscribe_all": true,
  "feed_recommendations_enabled": true,
  "top_karma_subreddits": true
}
```

## Reddit: List Trophies

`GET /accounts/{accountId}/reddit/trophies`

GET /api/v1/me/trophies. Cursor pagination: pass next_cursor back as cursor. Requires scopes: identity. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/trophies.

Access: `read` · MCP tool: `reddit-trophies-list`

### Path parameters

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

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "description": "string",
      "icon_url": "https://example.com",
      "granted_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"
}
```

## Reddit: List Followed users

`GET /accounts/{accountId}/reddit/friends`

GET /api/v1/me/friends. Users you follow (Reddit "friends"). Following must be a human action. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/friends.

Access: `read` · MCP tool: `reddit-friends-list`

### Path parameters

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

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

Response 200:

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

## Reddit: Create a Followed users item

`POST /accounts/{accountId}/reddit/friends`

PUT /api/v1/me/friends/{username}. Users you follow (Reddit "friends"). Following must be a human action. Requires scopes: read, subscribe. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/friends.

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

- `username` (string; required; ≥ 1 characters)

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

Response 201:

```json
{
  "id": "string",
  "username": "string",
  "user_id": "string",
  "since": "2026-10-13T09:00:00.000Z",
  "note": "string"
}
```

## Reddit: Delete a Followed users item

`DELETE /accounts/{accountId}/reddit/friends/{itemId}`

DELETE /api/v1/me/friends/{username}. Users you follow (Reddit "friends"). Following must be a human action. Requires scopes: read, subscribe. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/friends.

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

Response 200:

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

## Reddit: List Blocked users

`GET /accounts/{accountId}/reddit/blocked-users`

GET /prefs/blocked. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/blocked-users.

Access: `read` · MCP tool: `reddit-blocked-users-list`

### Path parameters

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

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

Response 200:

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

## Reddit: Create a Blocked users item

`POST /accounts/{accountId}/reddit/blocked-users`

POST /api/block_user (approved OAuth apps only). Requires scopes: read, account. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/blocked-users.

Access: `write` · MCP tool: `reddit-blocked-users-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

- `username` (string; required; ≥ 1 characters)

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

Response 201:

```json
{
  "id": "string",
  "username": "string",
  "user_id": "string",
  "since": "2026-10-13T09:00:00.000Z",
  "note": "string"
}
```

## Reddit: Delete a Blocked users item

`DELETE /accounts/{accountId}/reddit/blocked-users/{itemId}`

POST /r/all/api/unfriend type=enemy (scope unverified). Requires scopes: read, account. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/blocked-users.

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

Response 200:

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

## Reddit: List My posts

`GET /accounts/{accountId}/reddit/my-posts`

GET /user/{me}/submitted. Posts you submitted. Compose new posts, edit text bodies, toggle flags and flair, delete. Cursor pagination: pass next_cursor back as cursor. Requires scopes: history. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-posts.

Access: `read` · MCP tool: `reddit-my-posts-list` · Zernio: `GET /v1/accounts/{accountId}/posts`, `GET /v1/inbox/comments`

### Path parameters

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

### Query parameters

- `cursor` (string): Pagination cursor (Reddit after fullname)
- `limit` (integer; 1–100)
- `sort` (string; one of new, hot, top, controversial)
- `t` (string; one of hour, day, week, month, year, all): Time filter for top/controversial

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "short_id": "string",
      "title": "string",
      "text": "string",
      "url": "https://example.com",
      "permalink": "https://example.com",
      "subreddit": "string",
      "author": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "edited_at": "2026-10-13T09:00:00.000Z",
      "score": 1,
      "upvote_ratio": 0,
      "num_comments": 1,
      "num_crossposts": 1,
      "awards": 1,
      "view_count": 1,
      "kind": "self",
      "domain": "string",
      "thumbnail": "https://example.com",
      "flair_text": "string",
      "flair_template_id": "string",
      "over_18": true,
      "spoiler": true,
      "locked": true,
      "stickied": true,
      "archived": true,
      "distinguished": "string",
      "send_replies": true,
      "saved": true,
      "hidden": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Reddit: Create a My posts item

`POST /accounts/{accountId}/reddit/my-posts`

Publish now (POST /api/submit | submit_gallery_post | submit_poll_post). Posts you submitted. Compose new posts, edit text bodies, toggle flags and flair, delete. Requires scopes: history, submit. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-posts.

Access: `write` · MCP tool: `reddit-my-posts-create` · Zernio: `POST /v1/posts/{postId}/edit`, `POST /v1/posts/{postId}/unpublish`, `POST /v1/accounts/{accountId}/reddit-flairs`

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

- `subreddit` (string; required; ≥ 1 characters): Subreddit name without r/
- `title` (string; required; 1–300 characters)
- `text` (string): Markdown body. Use {media1}… placeholders to position inline media.
- `kind` (string; one of auto, self, link, image, video, videogif, gallery, poll, crosspost)
- `url` (string (uri)): Link post URL
- `media` (array of string; ≤ 20 items)
- `flairId` (string; ≤ 36 characters)
- `flairText` (string; ≤ 64 characters)
- `nsfw` (boolean)
- `spoiler` (boolean)
- `sendReplies` (boolean)
- `videogif` (boolean)
- `nativeVideo` (boolean)
- `bodyWithMedia` (string; one of inline, comment, drop)
- `poll` (object)
  - `poll.options` (array of string; 2–6 items)
  - `poll.duration` (integer; 1–7)
- `crosspostOf` (string): t3_ id or permalink
- `collectionId` (string)
- `firstComment` (string)
- `firstCommentSticky` (boolean)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/my-posts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "subreddit": "string",
    "title": "string",
    "text": "string",
    "kind": "auto",
    "url": "https://example.com"
  }'
```

Response 201:

```json
{
  "id": "string",
  "short_id": "string",
  "title": "string",
  "text": "string",
  "url": "https://example.com",
  "permalink": "https://example.com",
  "subreddit": "string",
  "author": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "edited_at": "2026-10-13T09:00:00.000Z",
  "score": 1,
  "upvote_ratio": 0,
  "num_comments": 1,
  "num_crossposts": 1,
  "awards": 1,
  "view_count": 1,
  "kind": "self",
  "domain": "string",
  "thumbnail": "https://example.com",
  "flair_text": "string",
  "flair_template_id": "string",
  "over_18": true,
  "spoiler": true,
  "locked": true,
  "stickied": true,
  "archived": true,
  "distinguished": "string",
  "send_replies": true,
  "saved": true,
  "hidden": true,
  "my_vote": -1,
  "removed_by_category": "string",
  "num_reports": 1,
  "poll": {
    "total_votes": 1,
    "ends_at": "2026-10-13T09:00:00.000Z",
    "options": [
      {
        "id": "string",
        "text": "string",
        "votes": 1
      }
    ]
  },
  "gallery": [
    {
      "media_id": "string",
      "caption": "string",
      "outbound_url": "https://example.com",
      "url": "https://example.com"
    }
  ],
  "video_url": "https://example.com"
}
```

## Reddit: Get a My posts item

`GET /accounts/{accountId}/reddit/my-posts/{itemId}`

GET /api/info. Posts you submitted. Compose new posts, edit text bodies, toggle flags and flair, delete. Requires scopes: history, read. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-posts.

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

Response 200:

```json
{
  "id": "string",
  "short_id": "string",
  "title": "string",
  "text": "string",
  "url": "https://example.com",
  "permalink": "https://example.com",
  "subreddit": "string",
  "author": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "edited_at": "2026-10-13T09:00:00.000Z",
  "score": 1,
  "upvote_ratio": 0,
  "num_comments": 1,
  "num_crossposts": 1,
  "awards": 1,
  "view_count": 1,
  "kind": "self",
  "domain": "string",
  "thumbnail": "https://example.com",
  "flair_text": "string",
  "flair_template_id": "string",
  "over_18": true,
  "spoiler": true,
  "locked": true,
  "stickied": true,
  "archived": true,
  "distinguished": "string",
  "send_replies": true,
  "saved": true,
  "hidden": true,
  "my_vote": -1,
  "removed_by_category": "string",
  "num_reports": 1,
  "poll": {
    "total_votes": 1,
    "ends_at": "2026-10-13T09:00:00.000Z",
    "options": [
      {
        "id": "string",
        "text": "string",
        "votes": 1
      }
    ]
  },
  "gallery": [
    {
      "media_id": "string",
      "caption": "string",
      "outbound_url": "https://example.com",
      "url": "https://example.com"
    }
  ],
  "video_url": "https://example.com"
}
```

## Reddit: Update a My posts item

`PATCH /accounts/{accountId}/reddit/my-posts/{itemId}`

POST /api/editusertext (+ flags/flair). Titles cannot be edited. Posts you submitted. Compose new posts, edit text bodies, toggle flags and flair, delete. Requires scopes: history, edit. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-posts.

Access: `write` · MCP tool: `reddit-my-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)
- `nsfw` (boolean)
- `spoiler` (boolean)
- `sendReplies` (boolean)
- `flairId` (string)
- `flairText` (string)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/my-posts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string",
    "nsfw": true,
    "spoiler": true,
    "sendReplies": true,
    "flairId": "string"
  }'
```

Response 200:

```json
{
  "id": "string",
  "short_id": "string",
  "title": "string",
  "text": "string",
  "url": "https://example.com",
  "permalink": "https://example.com",
  "subreddit": "string",
  "author": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "edited_at": "2026-10-13T09:00:00.000Z",
  "score": 1,
  "upvote_ratio": 0,
  "num_comments": 1,
  "num_crossposts": 1,
  "awards": 1,
  "view_count": 1,
  "kind": "self",
  "domain": "string",
  "thumbnail": "https://example.com",
  "flair_text": "string",
  "flair_template_id": "string",
  "over_18": true,
  "spoiler": true,
  "locked": true,
  "stickied": true,
  "archived": true,
  "distinguished": "string",
  "send_replies": true,
  "saved": true,
  "hidden": true,
  "my_vote": -1,
  "removed_by_category": "string",
  "num_reports": 1,
  "poll": {
    "total_votes": 1,
    "ends_at": "2026-10-13T09:00:00.000Z",
    "options": [
      {
        "id": "string",
        "text": "string",
        "votes": 1
      }
    ]
  },
  "gallery": [
    {
      "media_id": "string",
      "caption": "string",
      "outbound_url": "https://example.com",
      "url": "https://example.com"
    }
  ],
  "video_url": "https://example.com"
}
```

## Reddit: Delete a My posts item

`DELETE /accounts/{accountId}/reddit/my-posts/{itemId}`

POST /api/del. Posts you submitted. Compose new posts, edit text bodies, toggle flags and flair, delete. Requires scopes: history, edit. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-posts.

Access: `write` · MCP tool: `reddit-my-posts-delete`

### Path parameters

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

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/my-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
}
```

## Reddit: Set flair (My posts)

`POST /accounts/{accountId}/reddit/my-posts/{itemId}/set-flair`

Set flair. Posts you submitted. Compose new posts, edit text bodies, toggle flags and flair, delete. Requires scopes: history, flair. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-posts.

Access: `write` · MCP tool: `reddit-my-posts-set-flair`

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

- `flairTemplateId` (string)
- `text` (string; ≤ 64 characters)
- `subreddit` (string)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/my-posts/ITEM_ID/set-flair" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "flairTemplateId": "string",
    "text": "string",
    "subreddit": "string"
  }'
```

Response 200:

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

## Reddit: Inbox replies on/off (My posts)

`POST /accounts/{accountId}/reddit/my-posts/{itemId}/toggle-replies`

Inbox replies on/off. Posts you submitted. Compose new posts, edit text bodies, toggle flags and flair, delete. Requires scopes: history, edit. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-posts.

Access: `write` · MCP tool: `reddit-my-posts-toggle-replies`

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

- `state` (boolean; required)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/my-posts/ITEM_ID/toggle-replies" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "state": true
  }'
```

Response 200:

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

## Reddit: Add comment (My posts)

`POST /accounts/{accountId}/reddit/my-posts/{itemId}/comment`

Add comment. Posts you submitted. Compose new posts, edit text bodies, toggle flags and flair, delete. Requires scopes: history, submit. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-posts.

Access: `write` · MCP tool: `reddit-my-posts-comment`

### 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; ≥ 1 characters)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/my-posts/ITEM_ID/comment" \
  -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
}
```

## Reddit: Find processed media post (My posts)

`POST /accounts/{accountId}/reddit/my-posts/reconcile`

Resolve an image/video post whose processing outlived publish() (title + subreddit + submittedAt). Posts you submitted. Compose new posts, edit text bodies, toggle flags and flair, delete. Requires scopes: history. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-posts.

Access: `write` · MCP tool: `reddit-my-posts-reconcile`

### 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)
- `subreddit` (string; required)
- `submittedAt` (string (date-time))

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/my-posts/reconcile" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "string",
    "subreddit": "string",
    "submittedAt": "2026-10-13T09:00:00.000Z"
  }'
```

Response 200:

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

## Reddit: Vote (My posts)

`POST /accounts/{accountId}/reddit/my-posts/{itemId}/vote`

Upvote (1), downvote (-1) or clear (0). Human click only; never automate or batch. Posts you submitted. Compose new posts, edit text bodies, toggle flags and flair, delete. Requires scopes: history, vote. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-posts.

Access: `write` · MCP tool: `reddit-my-posts-vote`

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

- `direction` (integer; required; one of 1, 0, -1)

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

Response 200:

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

## Reddit: Save (My posts)

`POST /accounts/{accountId}/reddit/my-posts/{itemId}/save`

Save. Posts you submitted. Compose new posts, edit text bodies, toggle flags and flair, delete. Requires scopes: history, save. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-posts.

Access: `write` · MCP tool: `reddit-my-posts-save`

### Path parameters

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

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `category` (string): Saved category (Reddit Premium)

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

Response 200:

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

## Reddit: Unsave (My posts)

`POST /accounts/{accountId}/reddit/my-posts/{itemId}/unsave`

Unsave. Posts you submitted. Compose new posts, edit text bodies, toggle flags and flair, delete. Requires scopes: history, save. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-posts.

Access: `write` · MCP tool: `reddit-my-posts-unsave`

### 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/reddit/my-posts/ITEM_ID/unsave" \
  -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
}
```

## Reddit: Report (My posts)

`POST /accounts/{accountId}/reddit/my-posts/{itemId}/report`

Report. Posts you submitted. Compose new posts, edit text bodies, toggle flags and flair, delete. Requires scopes: history, report. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-posts.

Access: `write` · MCP tool: `reddit-my-posts-report`

### Path parameters

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

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `reason` (string; ≤ 100 characters): Reason text
- `rule_reason` (string): Subreddit rule short_name
- `site_reason` (string): Site-wide rule
- `custom_text` (string; ≤ 2000 characters)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/my-posts/ITEM_ID/report" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "reason": "string",
    "rule_reason": "string",
    "site_reason": "string",
    "custom_text": "string"
  }'
```

Response 200:

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

## Reddit: Hide (My posts)

`POST /accounts/{accountId}/reddit/my-posts/{itemId}/hide`

Hide. Posts you submitted. Compose new posts, edit text bodies, toggle flags and flair, delete. Requires scopes: history, report. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-posts.

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

## Reddit: Unhide (My posts)

`POST /accounts/{accountId}/reddit/my-posts/{itemId}/unhide`

Unhide. Posts you submitted. Compose new posts, edit text bodies, toggle flags and flair, delete. Requires scopes: history, report. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-posts.

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

## Reddit: Follow post (My posts)

`POST /accounts/{accountId}/reddit/my-posts/{itemId}/follow`

Follow post. Posts you submitted. Compose new posts, edit text bodies, toggle flags and flair, delete. Requires scopes: history, subscribe. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-posts.

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

### Body

- `follow` (boolean)

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

Response 200:

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

## Reddit: Crosspost (My posts)

`POST /accounts/{accountId}/reddit/my-posts/{itemId}/crosspost`

Crosspost to one subreddit (customise the title; no mass cross-posting). Posts you submitted. Compose new posts, edit text bodies, toggle flags and flair, delete. Requires scopes: history, submit. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-posts.

Access: `write` · MCP tool: `reddit-my-posts-crosspost`

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

- `subreddit` (string; required; ≥ 1 characters): Subreddit name without r/
- `title` (string; required; ≤ 300 characters)
- `nsfw` (boolean)
- `spoiler` (boolean)
- `flairId` (string)
- `flairText` (string)
- `sendReplies` (boolean)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/my-posts/ITEM_ID/crosspost" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "subreddit": "string",
    "title": "string",
    "nsfw": true,
    "spoiler": true,
    "flairId": "string"
  }'
```

Response 200:

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

## Reddit: List My comments

`GET /accounts/{accountId}/reddit/my-comments`

GET /user/{me}/comments. Cursor pagination: pass next_cursor back as cursor. Requires scopes: history. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-comments.

Access: `read` · MCP tool: `reddit-my-comments-list`

### Path parameters

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

### Query parameters

- `cursor` (string): Pagination cursor (Reddit after fullname)
- `limit` (integer; 1–100)
- `sort` (string; one of new, hot, top, controversial)
- `t` (string; one of hour, day, week, month, year, all): Time filter for top/controversial

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "text": "string",
      "author": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "edited_at": "2026-10-13T09:00:00.000Z",
      "score": 1,
      "like_count": 1,
      "parent_id": "string",
      "post_id": "string",
      "post_title": "string",
      "subreddit": "string",
      "permalink": "https://example.com",
      "depth": 0,
      "replies_count": 1,
      "is_submitter": true,
      "is_own": true,
      "distinguished": "string",
      "stickied": true,
      "locked": true,
      "saved": true,
      "my_vote": -1,
      "removed": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Reddit: Update a My comments item

`PATCH /accounts/{accountId}/reddit/my-comments/{itemId}`

POST /api/editusertext. Requires scopes: history, edit. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-comments.

Access: `write` · MCP tool: `reddit-my-comments-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; ≥ 1 characters)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/my-comments/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string"
  }'
```

Response 200:

```json
{
  "id": "string",
  "text": "string",
  "author": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "edited_at": "2026-10-13T09:00:00.000Z",
  "score": 1,
  "like_count": 1,
  "parent_id": "string",
  "post_id": "string",
  "post_title": "string",
  "subreddit": "string",
  "permalink": "https://example.com",
  "depth": 0,
  "replies_count": 1,
  "is_submitter": true,
  "is_own": true,
  "distinguished": "string",
  "stickied": true,
  "locked": true,
  "saved": true,
  "my_vote": -1,
  "removed": true
}
```

## Reddit: Delete a My comments item

`DELETE /accounts/{accountId}/reddit/my-comments/{itemId}`

POST /api/del. Requires scopes: history, edit. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-comments.

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

Response 200:

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

## Reddit: Pin (sticky as moderator) (My comments)

`POST /accounts/{accountId}/reddit/my-comments/{itemId}/pin`

Pin (sticky as moderator). Requires scopes: history, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-comments.

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

### Body

- `pin` (boolean)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/my-comments/ITEM_ID/pin" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "pin": true
  }'
```

Response 200:

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

## Reddit: Vote (My comments)

`POST /accounts/{accountId}/reddit/my-comments/{itemId}/vote`

Upvote (1), downvote (-1) or clear (0). Human click only; never automate or batch. Requires scopes: history, vote. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-comments.

Access: `write` · MCP tool: `reddit-my-comments-vote`

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

- `direction` (integer; required; one of 1, 0, -1)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/my-comments/ITEM_ID/vote" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "direction": 1
  }'
```

Response 200:

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

## Reddit: Save (My comments)

`POST /accounts/{accountId}/reddit/my-comments/{itemId}/save`

Save. Requires scopes: history, save. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-comments.

Access: `write` · MCP tool: `reddit-my-comments-save`

### Path parameters

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

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `category` (string): Saved category (Reddit Premium)

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

Response 200:

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

## Reddit: Unsave (My comments)

`POST /accounts/{accountId}/reddit/my-comments/{itemId}/unsave`

Unsave. Requires scopes: history, save. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-comments.

Access: `write` · MCP tool: `reddit-my-comments-unsave`

### 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/reddit/my-comments/ITEM_ID/unsave" \
  -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
}
```

## Reddit: Report (My comments)

`POST /accounts/{accountId}/reddit/my-comments/{itemId}/report`

Report. Requires scopes: history, report. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-comments.

Access: `write` · MCP tool: `reddit-my-comments-report`

### Path parameters

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

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `reason` (string; ≤ 100 characters): Reason text
- `rule_reason` (string): Subreddit rule short_name
- `site_reason` (string): Site-wide rule
- `custom_text` (string; ≤ 2000 characters)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/my-comments/ITEM_ID/report" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "reason": "string",
    "rule_reason": "string",
    "site_reason": "string",
    "custom_text": "string"
  }'
```

Response 200:

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

## Reddit: List Saved

`GET /accounts/{accountId}/reddit/saved`

GET /user/{me}/saved. Cursor pagination: pass next_cursor back as cursor. Requires scopes: history. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/saved.

Access: `read` · MCP tool: `reddit-saved-list`

### Path parameters

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

### Query parameters

- `cursor` (string): Pagination cursor (Reddit after fullname)
- `limit` (integer; 1–100)
- `type` (string; one of links, comments)
- `category` (string)

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "short_id": "string",
      "title": "string",
      "text": "string",
      "url": "https://example.com",
      "permalink": "https://example.com",
      "subreddit": "string",
      "author": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "edited_at": "2026-10-13T09:00:00.000Z",
      "score": 1,
      "upvote_ratio": 0,
      "num_comments": 1,
      "num_crossposts": 1,
      "awards": 1,
      "view_count": 1,
      "kind": "post",
      "domain": "string",
      "thumbnail": "https://example.com",
      "flair_text": "string",
      "flair_template_id": "string",
      "over_18": true,
      "spoiler": true,
      "locked": true,
      "stickied": true,
      "archived": true,
      "distinguished": "string",
      "send_replies": true,
      "saved": true,
      "hidden": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Reddit: Delete a Saved item

`DELETE /accounts/{accountId}/reddit/saved/{itemId}`

POST /api/unsave. Requires scopes: history, save. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/saved.

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

Response 200:

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

## Reddit: Saved categories (Saved)

`POST /accounts/{accountId}/reddit/saved/categories`

Saved categories. Requires scopes: history, save. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/saved.

Access: `write` · MCP tool: `reddit-saved-categories`

### Path parameters

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

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/saved/categories" \
  -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
}
```

## Reddit: Save item (Saved)

`POST /accounts/{accountId}/reddit/saved/save`

Save item. Requires scopes: history, save. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/saved.

Access: `write` · MCP tool: `reddit-saved-save`

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

- `id` (string; required)
- `category` (string)

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

Response 200:

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

## Reddit: List Hidden posts

`GET /accounts/{accountId}/reddit/hidden`

GET /user/{me}/hidden. Cursor pagination: pass next_cursor back as cursor. Requires scopes: history. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/hidden.

Access: `read` · MCP tool: `reddit-hidden-list`

### Path parameters

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

### Query parameters

- `cursor` (string): Pagination cursor (Reddit after fullname)
- `limit` (integer; 1–100)

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "short_id": "string",
      "title": "string",
      "text": "string",
      "url": "https://example.com",
      "permalink": "https://example.com",
      "subreddit": "string",
      "author": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "edited_at": "2026-10-13T09:00:00.000Z",
      "score": 1,
      "upvote_ratio": 0,
      "num_comments": 1,
      "num_crossposts": 1,
      "awards": 1,
      "view_count": 1,
      "kind": "self",
      "domain": "string",
      "thumbnail": "https://example.com",
      "flair_text": "string",
      "flair_template_id": "string",
      "over_18": true,
      "spoiler": true,
      "locked": true,
      "stickied": true,
      "archived": true,
      "distinguished": "string",
      "send_replies": true,
      "saved": true,
      "hidden": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Reddit: Delete a Hidden posts item

`DELETE /accounts/{accountId}/reddit/hidden/{itemId}`

POST /api/unhide. Requires scopes: history, report. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/hidden.

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

Response 200:

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

## Reddit: List Voted

`GET /accounts/{accountId}/reddit/voted`

GET /user/{me}/upvoted | downvoted. Posts you upvoted or downvoted. Removing an item clears your vote (human action). Cursor pagination: pass next_cursor back as cursor. Requires scopes: history. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/voted.

Access: `read` · MCP tool: `reddit-voted-list`

### Path parameters

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

### Query parameters

- `cursor` (string): Pagination cursor (Reddit after fullname)
- `limit` (integer; 1–100)
- `direction` (string; one of up, down)

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "short_id": "string",
      "title": "string",
      "text": "string",
      "url": "https://example.com",
      "permalink": "https://example.com",
      "subreddit": "string",
      "author": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "edited_at": "2026-10-13T09:00:00.000Z",
      "score": 1,
      "upvote_ratio": 0,
      "num_comments": 1,
      "num_crossposts": 1,
      "awards": 1,
      "view_count": 1,
      "kind": "self",
      "domain": "string",
      "thumbnail": "https://example.com",
      "flair_text": "string",
      "flair_template_id": "string",
      "over_18": true,
      "spoiler": true,
      "locked": true,
      "stickied": true,
      "archived": true,
      "distinguished": "string",
      "send_replies": true,
      "saved": true,
      "hidden": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Reddit: Delete a Voted item

`DELETE /accounts/{accountId}/reddit/voted/{itemId}`

POST /api/vote dir=0. Posts you upvoted or downvoted. Removing an item clears your vote (human action). Requires scopes: history, vote. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/voted.

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

Response 200:

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

## Reddit: List Activity overview

`GET /accounts/{accountId}/reddit/overview`

GET /user/{me}/overview. Cursor pagination: pass next_cursor back as cursor. Requires scopes: history. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/overview.

Access: `read` · MCP tool: `reddit-overview-list`

### Path parameters

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

### Query parameters

- `cursor` (string): Pagination cursor (Reddit after fullname)
- `limit` (integer; 1–100)
- `sort` (string; one of new, hot, top, controversial)
- `t` (string; one of hour, day, week, month, year, all): Time filter for top/controversial

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "short_id": "string",
      "title": "string",
      "text": "string",
      "url": "https://example.com",
      "permalink": "https://example.com",
      "subreddit": "string",
      "author": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "edited_at": "2026-10-13T09:00:00.000Z",
      "score": 1,
      "upvote_ratio": 0,
      "num_comments": 1,
      "num_crossposts": 1,
      "awards": 1,
      "view_count": 1,
      "kind": "post",
      "domain": "string",
      "thumbnail": "https://example.com",
      "flair_text": "string",
      "flair_template_id": "string",
      "over_18": true,
      "spoiler": true,
      "locked": true,
      "stickied": true,
      "archived": true,
      "distinguished": "string",
      "send_replies": true,
      "saved": true,
      "hidden": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Reddit: List My subreddits

`GET /accounts/{accountId}/reddit/my-subreddits`

GET /subreddits/mine/{where}. Subreddits you subscribe to, moderate or are approved in; choose the default posting subreddit. Cursor pagination: pass next_cursor back as cursor. Requires scopes: mysubreddits. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-subreddits.

Access: `read` · MCP tool: `reddit-my-subreddits-list` · Zernio: `GET /v1/accounts/{accountId}/reddit-subreddits`

### Path parameters

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

### Query parameters

- `cursor` (string): Pagination cursor (Reddit after fullname)
- `limit` (integer; 1–100)
- `where` (string; one of postable, subscriber, moderator, contributor, streams)

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "prefixed_name": "string",
      "title": "string",
      "description": "string",
      "subscribers": 1,
      "active_users": 1,
      "type": "public",
      "over_18": true,
      "submission_type": "any",
      "post_types": {
        "self": true,
        "link": true,
        "image": true,
        "video": true,
        "gallery": true,
        "videogif": true
      },
      "spoilers_enabled": true,
      "link_flair_enabled": true,
      "restrict_posting": true,
      "user_is_subscriber": true,
      "user_is_moderator": true,
      "user_is_contributor": true,
      "user_is_banned": true,
      "icon_url": "https://example.com",
      "banner_url": "https://example.com",
      "url": "https://example.com",
      "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"
}
```

## Reddit: Create a My subreddits item

`POST /accounts/{accountId}/reddit/my-subreddits`

POST /api/subscribe action=sub. Subreddits you subscribe to, moderate or are approved in; choose the default posting subreddit. Requires scopes: mysubreddits, subscribe. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-subreddits.

Access: `write` · MCP tool: `reddit-my-subreddits-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

- `subreddit` (string; required; ≥ 1 characters): Subreddit name without r/

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

Response 201:

```json
{
  "id": "string",
  "name": "string",
  "prefixed_name": "string",
  "title": "string",
  "description": "string",
  "subscribers": 1,
  "active_users": 1,
  "type": "public",
  "over_18": true,
  "submission_type": "any",
  "post_types": {
    "self": true,
    "link": true,
    "image": true,
    "video": true,
    "gallery": true,
    "videogif": true,
    "poll": true,
    "crosspost": true
  },
  "spoilers_enabled": true,
  "link_flair_enabled": true,
  "restrict_posting": true,
  "user_is_subscriber": true,
  "user_is_moderator": true,
  "user_is_contributor": true,
  "user_is_banned": true,
  "icon_url": "https://example.com",
  "banner_url": "https://example.com",
  "url": "https://example.com",
  "created_at": "2026-10-13T09:00:00.000Z"
}
```

## Reddit: Get a My subreddits item

`GET /accounts/{accountId}/reddit/my-subreddits/{itemId}`

GET /r/{sr}/about. Subreddits you subscribe to, moderate or are approved in; choose the default posting subreddit. Requires scopes: mysubreddits, read. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-subreddits.

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

Response 200:

```json
{
  "id": "string",
  "name": "string",
  "prefixed_name": "string",
  "title": "string",
  "description": "string",
  "subscribers": 1,
  "active_users": 1,
  "type": "public",
  "over_18": true,
  "submission_type": "any",
  "post_types": {
    "self": true,
    "link": true,
    "image": true,
    "video": true,
    "gallery": true,
    "videogif": true,
    "poll": true,
    "crosspost": true
  },
  "spoilers_enabled": true,
  "link_flair_enabled": true,
  "restrict_posting": true,
  "user_is_subscriber": true,
  "user_is_moderator": true,
  "user_is_contributor": true,
  "user_is_banned": true,
  "icon_url": "https://example.com",
  "banner_url": "https://example.com",
  "url": "https://example.com",
  "created_at": "2026-10-13T09:00:00.000Z"
}
```

## Reddit: Delete a My subreddits item

`DELETE /accounts/{accountId}/reddit/my-subreddits/{itemId}`

POST /api/subscribe action=unsub. Subreddits you subscribe to, moderate or are approved in; choose the default posting subreddit. Requires scopes: mysubreddits, subscribe. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-subreddits.

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

Response 200:

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

## Reddit: Set as default subreddit (My subreddits)

`POST /accounts/{accountId}/reddit/my-subreddits/{itemId}/set-default`

Returns { metadata: { defaultSubreddit } } for the API to persist on the account. Subreddits you subscribe to, moderate or are approved in; choose the default posting subreddit. Requires scopes: mysubreddits. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/my-subreddits.

Access: `write` · MCP tool: `reddit-my-subreddits-set-default` · Zernio: `PUT /v1/accounts/{accountId}/reddit-subreddits`

### 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/reddit/my-subreddits/ITEM_ID/set-default" \
  -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
}
```

## Reddit: List Subreddit browser

`GET /accounts/{accountId}/reddit/subreddits`

GET /subreddits/search | /subreddits/{popular,new,default}. Search and browse communities; open one to see its posting rules, allowed post types and requirements. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/subreddits.

Access: `read` · MCP tool: `reddit-subreddits-list` · Zernio: `GET /v1/tools/validate/subreddit`

### Path parameters

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

### Query parameters

- `cursor` (string): Pagination cursor (Reddit after fullname)
- `limit` (integer; 1–100)
- `q` (string): Search text (otherwise browse where)
- `where` (string; one of popular, new, default, gold)
- `include_nsfw` (boolean)

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "prefixed_name": "string",
      "title": "string",
      "description": "string",
      "subscribers": 1,
      "active_users": 1,
      "type": "public",
      "over_18": true,
      "submission_type": "any",
      "post_types": {
        "self": true,
        "link": true,
        "image": true,
        "video": true,
        "gallery": true,
        "videogif": true
      },
      "spoilers_enabled": true,
      "link_flair_enabled": true,
      "restrict_posting": true,
      "user_is_subscriber": true,
      "user_is_moderator": true,
      "user_is_contributor": true,
      "user_is_banned": true,
      "icon_url": "https://example.com",
      "banner_url": "https://example.com",
      "url": "https://example.com",
      "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"
}
```

## Reddit: Get a Subreddit browser item

`GET /accounts/{accountId}/reddit/subreddits/{itemId}`

GET /r/{sr}/about + /about/rules (validate subreddit). Search and browse communities; open one to see its posting rules, allowed post types and requirements. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/subreddits.

Access: `read` · MCP tool: `reddit-subreddits-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

### Query parameters

- `include_requirements` (boolean)

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

Response 200:

```json
{
  "id": "string",
  "name": "string",
  "prefixed_name": "string",
  "title": "string",
  "description": "string",
  "subscribers": 1,
  "active_users": 1,
  "type": "public",
  "over_18": true,
  "submission_type": "any",
  "post_types": {
    "self": true,
    "link": true,
    "image": true,
    "video": true,
    "gallery": true,
    "videogif": true,
    "poll": true,
    "crosspost": true
  },
  "spoilers_enabled": true,
  "link_flair_enabled": true,
  "restrict_posting": true,
  "user_is_subscriber": true,
  "user_is_moderator": true,
  "user_is_contributor": true,
  "user_is_banned": true,
  "icon_url": "https://example.com",
  "banner_url": "https://example.com",
  "url": "https://example.com",
  "created_at": "2026-10-13T09:00:00.000Z"
}
```

## Reddit: Subscribe (Subreddit browser)

`POST /accounts/{accountId}/reddit/subreddits/{itemId}/subscribe`

Subscribe. Search and browse communities; open one to see its posting rules, allowed post types and requirements. Requires scopes: read, subscribe. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/subreddits.

Access: `write` · MCP tool: `reddit-subreddits-subscribe`

### 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/reddit/subreddits/ITEM_ID/subscribe" \
  -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
}
```

## Reddit: Unsubscribe (Subreddit browser)

`POST /accounts/{accountId}/reddit/subreddits/{itemId}/unsubscribe`

Unsubscribe. Search and browse communities; open one to see its posting rules, allowed post types and requirements. Requires scopes: read, subscribe. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/subreddits.

Access: `write` · MCP tool: `reddit-subreddits-unsubscribe`

### 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/reddit/subreddits/ITEM_ID/unsubscribe" \
  -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
}
```

## Reddit: Posting requirements (Subreddit browser)

`POST /accounts/{accountId}/reddit/subreddits/{itemId}/requirements`

Posting requirements. Search and browse communities; open one to see its posting rules, allowed post types and requirements. Requires scopes: read, submit. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/subreddits.

Access: `write` · MCP tool: `reddit-subreddits-requirements`

### 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/reddit/subreddits/ITEM_ID/requirements" \
  -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
}
```

## Reddit: Submission guidelines (Subreddit browser)

`POST /accounts/{accountId}/reddit/subreddits/{itemId}/submit-text`

Submission guidelines. Search and browse communities; open one to see its posting rules, allowed post types and requirements. Requires scopes: read, submit. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/subreddits.

Access: `write` · MCP tool: `reddit-subreddits-submit-text`

### 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/reddit/subreddits/ITEM_ID/submit-text" \
  -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
}
```

## Reddit: Sidebar (Subreddit browser)

`POST /accounts/{accountId}/reddit/subreddits/{itemId}/sidebar`

Sidebar. Search and browse communities; open one to see its posting rules, allowed post types and requirements. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/subreddits.

Access: `write` · MCP tool: `reddit-subreddits-sidebar`

### 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/reddit/subreddits/ITEM_ID/sidebar" \
  -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
}
```

## Reddit: Get a Subreddit feed item

`GET /accounts/{accountId}/reddit/feed/{itemId}`

GET /api/info. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.

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

Response 200:

```json
{
  "id": "string",
  "short_id": "string",
  "title": "string",
  "text": "string",
  "url": "https://example.com",
  "permalink": "https://example.com",
  "subreddit": "string",
  "author": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "edited_at": "2026-10-13T09:00:00.000Z",
  "score": 1,
  "upvote_ratio": 0,
  "num_comments": 1,
  "num_crossposts": 1,
  "awards": 1,
  "view_count": 1,
  "kind": "self",
  "domain": "string",
  "thumbnail": "https://example.com",
  "flair_text": "string",
  "flair_template_id": "string",
  "over_18": true,
  "spoiler": true,
  "locked": true,
  "stickied": true,
  "archived": true,
  "distinguished": "string",
  "send_replies": true,
  "saved": true,
  "hidden": true,
  "my_vote": -1,
  "removed_by_category": "string",
  "num_reports": 1,
  "poll": {
    "total_votes": 1,
    "ends_at": "2026-10-13T09:00:00.000Z",
    "options": [
      {
        "id": "string",
        "text": "string",
        "votes": 1
      }
    ]
  },
  "gallery": [
    {
      "media_id": "string",
      "caption": "string",
      "outbound_url": "https://example.com",
      "url": "https://example.com"
    }
  ],
  "video_url": "https://example.com"
}
```

## Reddit: Vote (Subreddit feed)

`POST /accounts/{accountId}/reddit/feed/{itemId}/vote`

Upvote (1), downvote (-1) or clear (0). Human click only; never automate or batch. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, vote. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.

Access: `write` · MCP tool: `reddit-feed-vote` · Zernio: `POST /v1/accounts/{accountId}/reddit-vote`

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

- `direction` (integer; required; one of 1, 0, -1)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/feed/ITEM_ID/vote" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "direction": 1
  }'
```

Response 200:

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

## Reddit: Save (Subreddit feed)

`POST /accounts/{accountId}/reddit/feed/{itemId}/save`

Save. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, save. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.

Access: `write` · MCP tool: `reddit-feed-save`

### Path parameters

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

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `category` (string): Saved category (Reddit Premium)

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

Response 200:

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

## Reddit: Unsave (Subreddit feed)

`POST /accounts/{accountId}/reddit/feed/{itemId}/unsave`

Unsave. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, save. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.

Access: `write` · MCP tool: `reddit-feed-unsave`

### 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/reddit/feed/ITEM_ID/unsave" \
  -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
}
```

## Reddit: Report (Subreddit feed)

`POST /accounts/{accountId}/reddit/feed/{itemId}/report`

Report. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, report. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.

Access: `write` · MCP tool: `reddit-feed-report`

### Path parameters

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

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `reason` (string; ≤ 100 characters): Reason text
- `rule_reason` (string): Subreddit rule short_name
- `site_reason` (string): Site-wide rule
- `custom_text` (string; ≤ 2000 characters)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/feed/ITEM_ID/report" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "reason": "string",
    "rule_reason": "string",
    "site_reason": "string",
    "custom_text": "string"
  }'
```

Response 200:

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

## Reddit: Hide (Subreddit feed)

`POST /accounts/{accountId}/reddit/feed/{itemId}/hide`

Hide. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, report. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.

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

## Reddit: Unhide (Subreddit feed)

`POST /accounts/{accountId}/reddit/feed/{itemId}/unhide`

Unhide. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, report. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.

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

## Reddit: Follow post (Subreddit feed)

`POST /accounts/{accountId}/reddit/feed/{itemId}/follow`

Follow post. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, subscribe. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.

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

### Body

- `follow` (boolean)

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

Response 200:

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

## Reddit: Crosspost (Subreddit feed)

`POST /accounts/{accountId}/reddit/feed/{itemId}/crosspost`

Crosspost to one subreddit (customise the title; no mass cross-posting). Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, submit. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.

Access: `write` · MCP tool: `reddit-feed-crosspost`

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

- `subreddit` (string; required; ≥ 1 characters): Subreddit name without r/
- `title` (string; required; ≤ 300 characters)
- `nsfw` (boolean)
- `spoiler` (boolean)
- `flairId` (string)
- `flairText` (string)
- `sendReplies` (boolean)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/feed/ITEM_ID/crosspost" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "subreddit": "string",
    "title": "string",
    "nsfw": true,
    "spoiler": true,
    "flairId": "string"
  }'
```

Response 200:

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

## Reddit: Approve (Subreddit feed)

`POST /accounts/{accountId}/reddit/feed/{itemId}/approve`

Approve. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.

Access: `write` · MCP tool: `reddit-feed-approve`

### 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/reddit/feed/ITEM_ID/approve" \
  -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
}
```

## Reddit: Remove (Subreddit feed)

`POST /accounts/{accountId}/reddit/feed/{itemId}/remove`

Remove. Hot/new/top/rising posts of a subreddit (or your front page). Destructive. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.

Access: `write` · MCP tool: `reddit-feed-remove`

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

- `spam` (boolean)
- `reason_id` (string): Removal reason id
- `mod_note` (string; ≤ 100 characters): Private note for the mod log

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/feed/ITEM_ID/remove" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "spam": false,
    "reason_id": "string",
    "mod_note": "string"
  }'
```

Response 200:

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

## Reddit: Send removal message (Subreddit feed)

`POST /accounts/{accountId}/reddit/feed/{itemId}/send-removal-message`

Send removal message. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.

Access: `write` · MCP tool: `reddit-feed-send-removal-message`

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

- `message` (string; required; ≥ 1 characters)
- `type` (string; one of public, private, private_exposed)
- `title` (string; ≤ 50 characters): Subject (private messages)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/feed/ITEM_ID/send-removal-message" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "string",
    "type": "public",
    "title": "string"
  }'
```

Response 200:

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

## Reddit: Distinguish (Subreddit feed)

`POST /accounts/{accountId}/reddit/feed/{itemId}/distinguish`

Distinguish. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.

Access: `write` · MCP tool: `reddit-feed-distinguish`

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

- `how` (string; one of yes, no, admin, special)
- `sticky` (boolean): Sticky (top-level own comments only)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/feed/ITEM_ID/distinguish" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "how": "yes",
    "sticky": true
  }'
```

Response 200:

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

## Reddit: Ignore reports (Subreddit feed)

`POST /accounts/{accountId}/reddit/feed/{itemId}/ignore-reports`

Ignore reports. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.

Access: `write` · MCP tool: `reddit-feed-ignore-reports`

### 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/reddit/feed/ITEM_ID/ignore-reports" \
  -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
}
```

## Reddit: Unignore reports (Subreddit feed)

`POST /accounts/{accountId}/reddit/feed/{itemId}/unignore-reports`

Unignore reports. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.

Access: `write` · MCP tool: `reddit-feed-unignore-reports`

### 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/reddit/feed/ITEM_ID/unignore-reports" \
  -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
}
```

## Reddit: Snooze reports (Subreddit feed)

`POST /accounts/{accountId}/reddit/feed/{itemId}/snooze-reports`

Snooze reports. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.

Access: `write` · MCP tool: `reddit-feed-snooze-reports`

### Path parameters

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

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `reason` (string; required): Report reason to snooze for 7 days

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

Response 200:

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

## Reddit: Unsnooze reports (Subreddit feed)

`POST /accounts/{accountId}/reddit/feed/{itemId}/unsnooze-reports`

Unsnooze reports. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.

Access: `write` · MCP tool: `reddit-feed-unsnooze-reports`

### Path parameters

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

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `reason` (string; required)

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

Response 200:

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

## Reddit: Lock (Subreddit feed)

`POST /accounts/{accountId}/reddit/feed/{itemId}/lock`

Lock. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.

Access: `write` · MCP tool: `reddit-feed-lock`

### 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/reddit/feed/ITEM_ID/lock" \
  -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
}
```

## Reddit: Unlock (Subreddit feed)

`POST /accounts/{accountId}/reddit/feed/{itemId}/unlock`

Unlock. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.

Access: `write` · MCP tool: `reddit-feed-unlock`

### 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/reddit/feed/ITEM_ID/unlock" \
  -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
}
```

## Reddit: Mark NSFW (Subreddit feed)

`POST /accounts/{accountId}/reddit/feed/{itemId}/mark-nsfw`

Mark NSFW. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.

Access: `write` · MCP tool: `reddit-feed-mark-nsfw`

### 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/reddit/feed/ITEM_ID/mark-nsfw" \
  -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
}
```

## Reddit: Unmark NSFW (Subreddit feed)

`POST /accounts/{accountId}/reddit/feed/{itemId}/unmark-nsfw`

Unmark NSFW. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.

Access: `write` · MCP tool: `reddit-feed-unmark-nsfw`

### 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/reddit/feed/ITEM_ID/unmark-nsfw" \
  -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
}
```

## Reddit: Mark spoiler (Subreddit feed)

`POST /accounts/{accountId}/reddit/feed/{itemId}/spoiler`

Mark spoiler. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.

Access: `write` · MCP tool: `reddit-feed-spoiler`

### 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/reddit/feed/ITEM_ID/spoiler" \
  -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
}
```

## Reddit: Unmark spoiler (Subreddit feed)

`POST /accounts/{accountId}/reddit/feed/{itemId}/unspoiler`

Unmark spoiler. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.

Access: `write` · MCP tool: `reddit-feed-unspoiler`

### 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/reddit/feed/ITEM_ID/unspoiler" \
  -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
}
```

## Reddit: Pin / unpin (Subreddit feed)

`POST /accounts/{accountId}/reddit/feed/{itemId}/sticky`

Pin / unpin. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.

Access: `write` · MCP tool: `reddit-feed-sticky`

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

- `state` (boolean)
- `num` (integer; 1–6): Highlight slot (1–6)
- `to_profile` (boolean)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/feed/ITEM_ID/sticky" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "state": true,
    "num": 1,
    "to_profile": true
  }'
```

Response 200:

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

## Reddit: Contest mode (Subreddit feed)

`POST /accounts/{accountId}/reddit/feed/{itemId}/contest-mode`

Contest mode. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.

Access: `write` · MCP tool: `reddit-feed-contest-mode`

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

- `state` (boolean)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/feed/ITEM_ID/contest-mode" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "state": true
  }'
```

Response 200:

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

## Reddit: Suggested sort (Subreddit feed)

`POST /accounts/{accountId}/reddit/feed/{itemId}/suggested-sort`

Suggested sort. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.

Access: `write` · MCP tool: `reddit-feed-suggested-sort`

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

- `sort` (string; required; one of confidence, top, new, controversial, old, random, qa, live, blank)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/feed/ITEM_ID/suggested-sort" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "sort": "confidence"
  }'
```

Response 200:

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

## Reddit: Crowd control level (Subreddit feed)

`POST /accounts/{accountId}/reddit/feed/{itemId}/crowd-control`

Crowd control level. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.

Access: `write` · MCP tool: `reddit-feed-crowd-control`

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

- `level` (integer; required; 0–3)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/feed/ITEM_ID/crowd-control" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "level": 0
  }'
```

Response 200:

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

## Reddit: Other discussions (Subreddit feed)

`POST /accounts/{accountId}/reddit/feed/{itemId}/duplicates`

Other discussions. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/feed.

Access: `write` · MCP tool: `reddit-feed-duplicates`

### 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/reddit/feed/ITEM_ID/duplicates" \
  -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
}
```

## Reddit: Vote (Search posts)

`POST /accounts/{accountId}/reddit/search/{itemId}/vote`

Upvote (1), downvote (-1) or clear (0). Human click only; never automate or batch. User-initiated search (no bulk collection / social listening). Requires scopes: read, vote. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/search.

Access: `write` · MCP tool: `reddit-search-vote`

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

- `direction` (integer; required; one of 1, 0, -1)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/search/ITEM_ID/vote" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "direction": 1
  }'
```

Response 200:

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

## Reddit: Save (Search posts)

`POST /accounts/{accountId}/reddit/search/{itemId}/save`

Save. User-initiated search (no bulk collection / social listening). Requires scopes: read, save. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/search.

Access: `write` · MCP tool: `reddit-search-save`

### Path parameters

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

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `category` (string): Saved category (Reddit Premium)

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

Response 200:

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

## Reddit: Unsave (Search posts)

`POST /accounts/{accountId}/reddit/search/{itemId}/unsave`

Unsave. User-initiated search (no bulk collection / social listening). Requires scopes: read, save. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/search.

Access: `write` · MCP tool: `reddit-search-unsave`

### 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/reddit/search/ITEM_ID/unsave" \
  -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
}
```

## Reddit: Report (Search posts)

`POST /accounts/{accountId}/reddit/search/{itemId}/report`

Report. User-initiated search (no bulk collection / social listening). Requires scopes: read, report. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/search.

Access: `write` · MCP tool: `reddit-search-report`

### Path parameters

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

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `reason` (string; ≤ 100 characters): Reason text
- `rule_reason` (string): Subreddit rule short_name
- `site_reason` (string): Site-wide rule
- `custom_text` (string; ≤ 2000 characters)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/search/ITEM_ID/report" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "reason": "string",
    "rule_reason": "string",
    "site_reason": "string",
    "custom_text": "string"
  }'
```

Response 200:

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

## Reddit: Hide (Search posts)

`POST /accounts/{accountId}/reddit/search/{itemId}/hide`

Hide. User-initiated search (no bulk collection / social listening). Requires scopes: read, report. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/search.

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

## Reddit: Unhide (Search posts)

`POST /accounts/{accountId}/reddit/search/{itemId}/unhide`

Unhide. User-initiated search (no bulk collection / social listening). Requires scopes: read, report. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/search.

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

## Reddit: Follow post (Search posts)

`POST /accounts/{accountId}/reddit/search/{itemId}/follow`

Follow post. User-initiated search (no bulk collection / social listening). Requires scopes: read, subscribe. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/search.

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

### Body

- `follow` (boolean)

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

Response 200:

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

## Reddit: Crosspost (Search posts)

`POST /accounts/{accountId}/reddit/search/{itemId}/crosspost`

Crosspost to one subreddit (customise the title; no mass cross-posting). User-initiated search (no bulk collection / social listening). Requires scopes: read, submit. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/search.

Access: `write` · MCP tool: `reddit-search-crosspost`

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

- `subreddit` (string; required; ≥ 1 characters): Subreddit name without r/
- `title` (string; required; ≤ 300 characters)
- `nsfw` (boolean)
- `spoiler` (boolean)
- `flairId` (string)
- `flairText` (string)
- `sendReplies` (boolean)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/search/ITEM_ID/crosspost" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "subreddit": "string",
    "title": "string",
    "nsfw": true,
    "spoiler": true,
    "flairId": "string"
  }'
```

Response 200:

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

## Reddit: Approve (Search posts)

`POST /accounts/{accountId}/reddit/search/{itemId}/approve`

Approve. User-initiated search (no bulk collection / social listening). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/search.

Access: `write` · MCP tool: `reddit-search-approve`

### 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/reddit/search/ITEM_ID/approve" \
  -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
}
```

## Reddit: Remove (Search posts)

`POST /accounts/{accountId}/reddit/search/{itemId}/remove`

Remove. User-initiated search (no bulk collection / social listening). Destructive. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/search.

Access: `write` · MCP tool: `reddit-search-remove`

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

- `spam` (boolean)
- `reason_id` (string): Removal reason id
- `mod_note` (string; ≤ 100 characters): Private note for the mod log

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/search/ITEM_ID/remove" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "spam": false,
    "reason_id": "string",
    "mod_note": "string"
  }'
```

Response 200:

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

## Reddit: Send removal message (Search posts)

`POST /accounts/{accountId}/reddit/search/{itemId}/send-removal-message`

Send removal message. User-initiated search (no bulk collection / social listening). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/search.

Access: `write` · MCP tool: `reddit-search-send-removal-message`

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

- `message` (string; required; ≥ 1 characters)
- `type` (string; one of public, private, private_exposed)
- `title` (string; ≤ 50 characters): Subject (private messages)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/search/ITEM_ID/send-removal-message" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "string",
    "type": "public",
    "title": "string"
  }'
```

Response 200:

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

## Reddit: Distinguish (Search posts)

`POST /accounts/{accountId}/reddit/search/{itemId}/distinguish`

Distinguish. User-initiated search (no bulk collection / social listening). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/search.

Access: `write` · MCP tool: `reddit-search-distinguish`

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

- `how` (string; one of yes, no, admin, special)
- `sticky` (boolean): Sticky (top-level own comments only)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/search/ITEM_ID/distinguish" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "how": "yes",
    "sticky": true
  }'
```

Response 200:

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

## Reddit: Ignore reports (Search posts)

`POST /accounts/{accountId}/reddit/search/{itemId}/ignore-reports`

Ignore reports. User-initiated search (no bulk collection / social listening). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/search.

Access: `write` · MCP tool: `reddit-search-ignore-reports`

### 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/reddit/search/ITEM_ID/ignore-reports" \
  -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
}
```

## Reddit: Unignore reports (Search posts)

`POST /accounts/{accountId}/reddit/search/{itemId}/unignore-reports`

Unignore reports. User-initiated search (no bulk collection / social listening). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/search.

Access: `write` · MCP tool: `reddit-search-unignore-reports`

### 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/reddit/search/ITEM_ID/unignore-reports" \
  -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
}
```

## Reddit: Snooze reports (Search posts)

`POST /accounts/{accountId}/reddit/search/{itemId}/snooze-reports`

Snooze reports. User-initiated search (no bulk collection / social listening). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/search.

Access: `write` · MCP tool: `reddit-search-snooze-reports`

### Path parameters

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

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `reason` (string; required): Report reason to snooze for 7 days

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

Response 200:

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

## Reddit: Unsnooze reports (Search posts)

`POST /accounts/{accountId}/reddit/search/{itemId}/unsnooze-reports`

Unsnooze reports. User-initiated search (no bulk collection / social listening). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/search.

Access: `write` · MCP tool: `reddit-search-unsnooze-reports`

### Path parameters

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

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `reason` (string; required)

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

Response 200:

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

## Reddit: Lock (Search posts)

`POST /accounts/{accountId}/reddit/search/{itemId}/lock`

Lock. User-initiated search (no bulk collection / social listening). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/search.

Access: `write` · MCP tool: `reddit-search-lock`

### 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/reddit/search/ITEM_ID/lock" \
  -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
}
```

## Reddit: Unlock (Search posts)

`POST /accounts/{accountId}/reddit/search/{itemId}/unlock`

Unlock. User-initiated search (no bulk collection / social listening). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/search.

Access: `write` · MCP tool: `reddit-search-unlock`

### 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/reddit/search/ITEM_ID/unlock" \
  -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
}
```

## Reddit: Mark NSFW (Search posts)

`POST /accounts/{accountId}/reddit/search/{itemId}/mark-nsfw`

Mark NSFW. User-initiated search (no bulk collection / social listening). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/search.

Access: `write` · MCP tool: `reddit-search-mark-nsfw`

### 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/reddit/search/ITEM_ID/mark-nsfw" \
  -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
}
```

## Reddit: Unmark NSFW (Search posts)

`POST /accounts/{accountId}/reddit/search/{itemId}/unmark-nsfw`

Unmark NSFW. User-initiated search (no bulk collection / social listening). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/search.

Access: `write` · MCP tool: `reddit-search-unmark-nsfw`

### 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/reddit/search/ITEM_ID/unmark-nsfw" \
  -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
}
```

## Reddit: Mark spoiler (Search posts)

`POST /accounts/{accountId}/reddit/search/{itemId}/spoiler`

Mark spoiler. User-initiated search (no bulk collection / social listening). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/search.

Access: `write` · MCP tool: `reddit-search-spoiler`

### 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/reddit/search/ITEM_ID/spoiler" \
  -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
}
```

## Reddit: Unmark spoiler (Search posts)

`POST /accounts/{accountId}/reddit/search/{itemId}/unspoiler`

Unmark spoiler. User-initiated search (no bulk collection / social listening). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/search.

Access: `write` · MCP tool: `reddit-search-unspoiler`

### 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/reddit/search/ITEM_ID/unspoiler" \
  -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
}
```

## Reddit: Pin / unpin (Search posts)

`POST /accounts/{accountId}/reddit/search/{itemId}/sticky`

Pin / unpin. User-initiated search (no bulk collection / social listening). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/search.

Access: `write` · MCP tool: `reddit-search-sticky`

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

- `state` (boolean)
- `num` (integer; 1–6): Highlight slot (1–6)
- `to_profile` (boolean)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/search/ITEM_ID/sticky" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "state": true,
    "num": 1,
    "to_profile": true
  }'
```

Response 200:

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

## Reddit: Contest mode (Search posts)

`POST /accounts/{accountId}/reddit/search/{itemId}/contest-mode`

Contest mode. User-initiated search (no bulk collection / social listening). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/search.

Access: `write` · MCP tool: `reddit-search-contest-mode`

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

- `state` (boolean)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/search/ITEM_ID/contest-mode" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "state": true
  }'
```

Response 200:

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

## Reddit: Suggested sort (Search posts)

`POST /accounts/{accountId}/reddit/search/{itemId}/suggested-sort`

Suggested sort. User-initiated search (no bulk collection / social listening). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/search.

Access: `write` · MCP tool: `reddit-search-suggested-sort`

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

- `sort` (string; required; one of confidence, top, new, controversial, old, random, qa, live, blank)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/search/ITEM_ID/suggested-sort" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "sort": "confidence"
  }'
```

Response 200:

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

## Reddit: Crowd control level (Search posts)

`POST /accounts/{accountId}/reddit/search/{itemId}/crowd-control`

Crowd control level. User-initiated search (no bulk collection / social listening). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/search.

Access: `write` · MCP tool: `reddit-search-crowd-control`

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

- `level` (integer; required; 0–3)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/search/ITEM_ID/crowd-control" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "level": 0
  }'
```

Response 200:

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

## Reddit: List Post comments

`GET /accounts/{accountId}/reddit/post-comments`

GET /comments/{article}. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/post-comments.

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

### Path parameters

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

### Query parameters

- `post_id` (string; ≥ 1 characters): t3_ id, base36 id or permalink
- `sort` (string; one of best, top, new, controversial, old, qa)
- `comment_id` (string): Focus a sub-thread
- `depth` (integer; 1–10)
- `limit` (integer; 1–500)

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "text": "string",
      "author": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "edited_at": "2026-10-13T09:00:00.000Z",
      "score": 1,
      "like_count": 1,
      "parent_id": "string",
      "post_id": "string",
      "post_title": "string",
      "subreddit": "string",
      "permalink": "https://example.com",
      "depth": 0,
      "replies_count": 1,
      "is_submitter": true,
      "is_own": true,
      "distinguished": "string",
      "stickied": true,
      "locked": true,
      "saved": true,
      "my_vote": -1,
      "removed": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Reddit: Create a Post comments item

`POST /accounts/{accountId}/reddit/post-comments`

POST /api/comment. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, submit. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/post-comments.

Access: `write` · MCP tool: `reddit-post-comments-create` · Zernio: `POST /v1/inbox/comments/{postId}`, `POST /v1/inbox/comments/{postId}/{commentId}/like`, `POST /v1/inbox/comments/{postId}/{commentId}/pin`

### Path parameters

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

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `parent_id` (string; required): t3_ (post) or t1_ (comment) to reply to
- `text` (string; required; ≥ 1 characters)

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

Response 201:

```json
{
  "id": "string",
  "text": "string",
  "author": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "edited_at": "2026-10-13T09:00:00.000Z",
  "score": 1,
  "like_count": 1,
  "parent_id": "string",
  "post_id": "string",
  "post_title": "string",
  "subreddit": "string",
  "permalink": "https://example.com",
  "depth": 0,
  "replies_count": 1,
  "is_submitter": true,
  "is_own": true,
  "distinguished": "string",
  "stickied": true,
  "locked": true,
  "saved": true,
  "my_vote": -1,
  "removed": true
}
```

## Reddit: Update a Post comments item

`PATCH /accounts/{accountId}/reddit/post-comments/{itemId}`

POST /api/editusertext (own comments). The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, edit. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/post-comments.

Access: `write` · MCP tool: `reddit-post-comments-update` · Zernio: `PATCH /v1/inbox/comments/{postId}/{commentId}`

### 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; ≥ 1 characters)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/post-comments/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string"
  }'
```

Response 200:

```json
{
  "id": "string",
  "text": "string",
  "author": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "edited_at": "2026-10-13T09:00:00.000Z",
  "score": 1,
  "like_count": 1,
  "parent_id": "string",
  "post_id": "string",
  "post_title": "string",
  "subreddit": "string",
  "permalink": "https://example.com",
  "depth": 0,
  "replies_count": 1,
  "is_submitter": true,
  "is_own": true,
  "distinguished": "string",
  "stickied": true,
  "locked": true,
  "saved": true,
  "my_vote": -1,
  "removed": true
}
```

## Reddit: Delete a Post comments item

`DELETE /accounts/{accountId}/reddit/post-comments/{itemId}`

POST /api/del (own comments). The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, edit. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/post-comments.

Access: `write` · MCP tool: `reddit-post-comments-delete` · Zernio: `DELETE /v1/inbox/comments/{postId}`, `DELETE /v1/inbox/comments/{postId}/{commentId}/like`, `DELETE /v1/inbox/comments/{postId}/{commentId}/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

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

Response 200:

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

## Reddit: Reply (Post comments)

`POST /accounts/{accountId}/reddit/post-comments/{itemId}/reply`

Reply. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, submit. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/post-comments.

Access: `write` · MCP tool: `reddit-post-comments-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; ≥ 1 characters)

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

Response 200:

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

## Reddit: Load more comments (Post comments)

`POST /accounts/{accountId}/reddit/post-comments/load-more`

Load more comments. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/post-comments.

Access: `write` · MCP tool: `reddit-post-comments-load-more`

### 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)
- `children` (array of string; required)
- `sort` (string)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/post-comments/load-more" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "post_id": "string",
    "children": [
      "string"
    ],
    "sort": "string"
  }'
```

Response 200:

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

## Reddit: Vote (Post comments)

`POST /accounts/{accountId}/reddit/post-comments/{itemId}/vote`

Upvote (1), downvote (-1) or clear (0). Human click only; never automate or batch. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, vote. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/post-comments.

Access: `write` · MCP tool: `reddit-post-comments-vote`

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

- `direction` (integer; required; one of 1, 0, -1)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/post-comments/ITEM_ID/vote" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "direction": 1
  }'
```

Response 200:

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

## Reddit: Save (Post comments)

`POST /accounts/{accountId}/reddit/post-comments/{itemId}/save`

Save. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, save. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/post-comments.

Access: `write` · MCP tool: `reddit-post-comments-save`

### Path parameters

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

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `category` (string): Saved category (Reddit Premium)

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

Response 200:

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

## Reddit: Unsave (Post comments)

`POST /accounts/{accountId}/reddit/post-comments/{itemId}/unsave`

Unsave. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, save. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/post-comments.

Access: `write` · MCP tool: `reddit-post-comments-unsave`

### 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/reddit/post-comments/ITEM_ID/unsave" \
  -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
}
```

## Reddit: Report (Post comments)

`POST /accounts/{accountId}/reddit/post-comments/{itemId}/report`

Report. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, report. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/post-comments.

Access: `write` · MCP tool: `reddit-post-comments-report`

### Path parameters

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

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `reason` (string; ≤ 100 characters): Reason text
- `rule_reason` (string): Subreddit rule short_name
- `site_reason` (string): Site-wide rule
- `custom_text` (string; ≤ 2000 characters)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/post-comments/ITEM_ID/report" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "reason": "string",
    "rule_reason": "string",
    "site_reason": "string",
    "custom_text": "string"
  }'
```

Response 200:

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

## Reddit: Approve (Post comments)

`POST /accounts/{accountId}/reddit/post-comments/{itemId}/approve`

Approve. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/post-comments.

Access: `write` · MCP tool: `reddit-post-comments-approve`

### 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/reddit/post-comments/ITEM_ID/approve" \
  -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
}
```

## Reddit: Remove (Post comments)

`POST /accounts/{accountId}/reddit/post-comments/{itemId}/remove`

Remove. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Destructive. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/post-comments.

Access: `write` · MCP tool: `reddit-post-comments-remove`

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

- `spam` (boolean)
- `reason_id` (string): Removal reason id
- `mod_note` (string; ≤ 100 characters): Private note for the mod log

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/post-comments/ITEM_ID/remove" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "spam": false,
    "reason_id": "string",
    "mod_note": "string"
  }'
```

Response 200:

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

## Reddit: Send removal message (Post comments)

`POST /accounts/{accountId}/reddit/post-comments/{itemId}/send-removal-message`

Send removal message. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/post-comments.

Access: `write` · MCP tool: `reddit-post-comments-send-removal-message`

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

- `message` (string; required; ≥ 1 characters)
- `type` (string; one of public, private, private_exposed)
- `title` (string; ≤ 50 characters): Subject (private messages)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/post-comments/ITEM_ID/send-removal-message" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "string",
    "type": "public",
    "title": "string"
  }'
```

Response 200:

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

## Reddit: Distinguish (Post comments)

`POST /accounts/{accountId}/reddit/post-comments/{itemId}/distinguish`

Distinguish. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/post-comments.

Access: `write` · MCP tool: `reddit-post-comments-distinguish`

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

- `how` (string; one of yes, no, admin, special)
- `sticky` (boolean): Sticky (top-level own comments only)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/post-comments/ITEM_ID/distinguish" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "how": "yes",
    "sticky": true
  }'
```

Response 200:

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

## Reddit: Ignore reports (Post comments)

`POST /accounts/{accountId}/reddit/post-comments/{itemId}/ignore-reports`

Ignore reports. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/post-comments.

Access: `write` · MCP tool: `reddit-post-comments-ignore-reports`

### 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/reddit/post-comments/ITEM_ID/ignore-reports" \
  -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
}
```

## Reddit: Unignore reports (Post comments)

`POST /accounts/{accountId}/reddit/post-comments/{itemId}/unignore-reports`

Unignore reports. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/post-comments.

Access: `write` · MCP tool: `reddit-post-comments-unignore-reports`

### 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/reddit/post-comments/ITEM_ID/unignore-reports" \
  -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
}
```

## Reddit: Snooze reports (Post comments)

`POST /accounts/{accountId}/reddit/post-comments/{itemId}/snooze-reports`

Snooze reports. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/post-comments.

Access: `write` · MCP tool: `reddit-post-comments-snooze-reports`

### Path parameters

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

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `reason` (string; required): Report reason to snooze for 7 days

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/post-comments/ITEM_ID/snooze-reports" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "reason": "string"
  }'
```

Response 200:

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

## Reddit: Unsnooze reports (Post comments)

`POST /accounts/{accountId}/reddit/post-comments/{itemId}/unsnooze-reports`

Unsnooze reports. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/post-comments.

Access: `write` · MCP tool: `reddit-post-comments-unsnooze-reports`

### Path parameters

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

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `reason` (string; required)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/post-comments/ITEM_ID/unsnooze-reports" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "reason": "string"
  }'
```

Response 200:

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

## Reddit: Lock (Post comments)

`POST /accounts/{accountId}/reddit/post-comments/{itemId}/lock`

Lock. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/post-comments.

Access: `write` · MCP tool: `reddit-post-comments-lock`

### 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/reddit/post-comments/ITEM_ID/lock" \
  -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
}
```

## Reddit: Unlock (Post comments)

`POST /accounts/{accountId}/reddit/post-comments/{itemId}/unlock`

Unlock. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/post-comments.

Access: `write` · MCP tool: `reddit-post-comments-unlock`

### 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/reddit/post-comments/ITEM_ID/unlock" \
  -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
}
```

## Reddit: Show collapsed comment (Post comments)

`POST /accounts/{accountId}/reddit/post-comments/{itemId}/show-comment`

Show collapsed comment. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/post-comments.

Access: `write` · MCP tool: `reddit-post-comments-show-comment`

### 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/reddit/post-comments/ITEM_ID/show-comment" \
  -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
}
```

## Reddit: List Subreddit rules

`GET /accounts/{accountId}/reddit/subreddit-rules`

GET /r/{sr}/about/rules. Rules of a subreddit (shown in the composer). Moderators can add, edit, reorder and delete rules. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/subreddit-rules.

Access: `read` · MCP tool: `reddit-subreddit-rules-list` · Zernio: `GET /v1/accounts/{accountId}/reddit-subreddits/{subreddit}/rules`

### Path parameters

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

### Query parameters

- `subreddit` (string; ≥ 1 characters): Subreddit name without r/

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "priority": 1,
      "short_name": "string",
      "description": "string",
      "violation_reason": "string",
      "kind": "all",
      "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"
}
```

## Reddit: Create a Subreddit rules item

`POST /accounts/{accountId}/reddit/subreddit-rules`

POST /api/add_subreddit_rule (undocumented; scope unverified). Rules of a subreddit (shown in the composer). Moderators can add, edit, reorder and delete rules. Requires scopes: read, modconfig. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/subreddit-rules.

Access: `write` · MCP tool: `reddit-subreddit-rules-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

- `subreddit` (string; required; ≥ 1 characters): Subreddit name without r/
- `short_name` (string; required; ≤ 100 characters)
- `description` (string; ≤ 500 characters)
- `kind` (string; one of all, link, comment)
- `violation_reason` (string; ≤ 100 characters)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/subreddit-rules" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "subreddit": "string",
    "short_name": "string",
    "description": "string",
    "kind": "all",
    "violation_reason": "string"
  }'
```

Response 201:

```json
{
  "id": "string",
  "priority": 1,
  "short_name": "string",
  "description": "string",
  "violation_reason": "string",
  "kind": "all",
  "created_at": "2026-10-13T09:00:00.000Z"
}
```

## Reddit: Update a Subreddit rules item

`PATCH /accounts/{accountId}/reddit/subreddit-rules/{itemId}`

POST /api/update_subreddit_rule. Rules of a subreddit (shown in the composer). Moderators can add, edit, reorder and delete rules. Requires scopes: read, modconfig. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/subreddit-rules.

Access: `write` · MCP tool: `reddit-subreddit-rules-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

- `short_name` (string; ≤ 100 characters)
- `description` (string; ≤ 500 characters)
- `kind` (string; one of all, link, comment)
- `violation_reason` (string; ≤ 100 characters)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/subreddit-rules/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "short_name": "string",
    "description": "string",
    "kind": "all",
    "violation_reason": "string"
  }'
```

Response 200:

```json
{
  "id": "string",
  "priority": 1,
  "short_name": "string",
  "description": "string",
  "violation_reason": "string",
  "kind": "all",
  "created_at": "2026-10-13T09:00:00.000Z"
}
```

## Reddit: Delete a Subreddit rules item

`DELETE /accounts/{accountId}/reddit/subreddit-rules/{itemId}`

POST /api/remove_subreddit_rule. Rules of a subreddit (shown in the composer). Moderators can add, edit, reorder and delete rules. Requires scopes: read, modconfig. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/subreddit-rules.

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

Response 200:

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

## Reddit: Reorder rules (Subreddit rules)

`POST /accounts/{accountId}/reddit/subreddit-rules/reorder`

Reorder rules. Rules of a subreddit (shown in the composer). Moderators can add, edit, reorder and delete rules. Requires scopes: read, modconfig. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/subreddit-rules.

Access: `write` · MCP tool: `reddit-subreddit-rules-reorder`

### Path parameters

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

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `subreddit` (string; required; ≥ 1 characters): Subreddit name without r/
- `order` (array of string; required): short_names in the new order

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

Response 200:

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

## Reddit: List Post flair

`GET /accounts/{accountId}/reddit/post-flairs`

GET /r/{sr}/api/link_flair_v2. Link flair templates you can apply to your posts in a subreddit. Cursor pagination: pass next_cursor back as cursor. Requires scopes: flair. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/post-flairs.

Access: `read` · MCP tool: `reddit-post-flairs-list` · Zernio: `GET /v1/accounts/{accountId}/reddit-flairs`

### Path parameters

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

### Query parameters

- `subreddit` (string; ≥ 1 characters): Subreddit name without r/

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "text": "string",
      "textColor": "light",
      "backgroundColor": "string",
      "textEditable": true,
      "type": "text",
      "modOnly": true,
      "allowableContent": "all",
      "maxEmojis": 1,
      "cssClass": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Reddit: Apply to post (Post flair)

`POST /accounts/{accountId}/reddit/post-flairs/{itemId}/apply`

Apply to post. Link flair templates you can apply to your posts in a subreddit. Requires scopes: flair. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/post-flairs.

Access: `write` · MCP tool: `reddit-post-flairs-apply` · Zernio: `POST /v1/accounts/{accountId}/reddit-flairs`

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

- `subreddit` (string; ≥ 1 characters): Subreddit name without r/
- `post_id` (string; required)
- `text` (string; ≤ 64 characters)

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

Response 200:

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

## Reddit: List My user flair

`GET /accounts/{accountId}/reddit/user-flair`

GET /r/{sr}/api/user_flair_v2. User flair templates in a subreddit; select one as your flair or clear it. Cursor pagination: pass next_cursor back as cursor. Requires scopes: flair. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/user-flair.

Access: `read` · MCP tool: `reddit-user-flair-list`

### Path parameters

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

### Query parameters

- `subreddit` (string; ≥ 1 characters): Subreddit name without r/

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "text": "string",
      "textColor": "light",
      "backgroundColor": "string",
      "textEditable": true,
      "type": "text",
      "modOnly": true,
      "allowableContent": "all",
      "maxEmojis": 1,
      "cssClass": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Reddit: Use as my flair (My user flair)

`POST /accounts/{accountId}/reddit/user-flair/{itemId}/select`

Use as my flair. User flair templates in a subreddit; select one as your flair or clear it. Requires scopes: flair. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/user-flair.

Access: `write` · MCP tool: `reddit-user-flair-select`

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

- `subreddit` (string; required; ≥ 1 characters): Subreddit name without r/
- `text` (string; ≤ 64 characters)

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

Response 200:

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

## Reddit: Clear my flair (My user flair)

`POST /accounts/{accountId}/reddit/user-flair/clear`

Clear my flair. User flair templates in a subreddit; select one as your flair or clear it. Requires scopes: flair. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/user-flair.

Access: `write` · MCP tool: `reddit-user-flair-clear`

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

- `subreddit` (string; required; ≥ 1 characters): Subreddit name without r/

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

Response 200:

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

## Reddit: Show flair in this subreddit (My user flair)

`POST /accounts/{accountId}/reddit/user-flair/toggle-display`

Show flair in this subreddit. User flair templates in a subreddit; select one as your flair or clear it. Requires scopes: flair. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/user-flair.

Access: `write` · MCP tool: `reddit-user-flair-toggle-display`

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

- `subreddit` (string; required; ≥ 1 characters): Subreddit name without r/
- `enabled` (boolean; required)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/user-flair/toggle-display" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "subreddit": "string",
    "enabled": true
  }'
```

Response 200:

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

## Reddit: List Wiki

`GET /accounts/{accountId}/reddit/wiki`

GET /r/{sr}/wiki/pages. Read and edit subreddit wiki pages (including config/automoderator for mods); revisions, revert, page settings and editors. Cursor pagination: pass next_cursor back as cursor. Requires scopes: wikiread. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/wiki.

Access: `read` · MCP tool: `reddit-wiki-list`

### Path parameters

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

### Query parameters

- `subreddit` (string; ≥ 1 characters): Subreddit name without r/

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "subreddit": "string",
      "page": "string",
      "content_md": "string",
      "revision_id": "string",
      "revision_by": "string",
      "revision_date": "2026-10-13T09:00:00.000Z",
      "reason": "string",
      "may_revise": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Reddit: Create a Wiki item

`POST /accounts/{accountId}/reddit/wiki`

POST /r/{sr}/api/wiki/edit (new page). Read and edit subreddit wiki pages (including config/automoderator for mods); revisions, revert, page settings and editors. Requires scopes: wikiread, wikiedit. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/wiki.

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

- `subreddit` (string; required; ≥ 1 characters): Subreddit name without r/
- `page` (string; required; ≥ 1 characters)
- `content` (string; required)
- `reason` (string; ≤ 256 characters)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/wiki" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "subreddit": "string",
    "page": "string",
    "content": "string",
    "reason": "string"
  }'
```

Response 201:

```json
{
  "id": "string",
  "subreddit": "string",
  "page": "string",
  "content_md": "string",
  "revision_id": "string",
  "revision_by": "string",
  "revision_date": "2026-10-13T09:00:00.000Z",
  "reason": "string",
  "may_revise": true
}
```

## Reddit: Get a Wiki item

`GET /accounts/{accountId}/reddit/wiki/{itemId}`

GET /r/{sr}/wiki/{page}. Read and edit subreddit wiki pages (including config/automoderator for mods); revisions, revert, page settings and editors. Requires scopes: wikiread. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/wiki.

Access: `read` · MCP tool: `reddit-wiki-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

### Query parameters

- `revision` (string): Revision id (v)

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

Response 200:

```json
{
  "id": "string",
  "subreddit": "string",
  "page": "string",
  "content_md": "string",
  "revision_id": "string",
  "revision_by": "string",
  "revision_date": "2026-10-13T09:00:00.000Z",
  "reason": "string",
  "may_revise": true
}
```

## Reddit: Update a Wiki item

`PATCH /accounts/{accountId}/reddit/wiki/{itemId}`

POST /r/{sr}/api/wiki/edit. Read and edit subreddit wiki pages (including config/automoderator for mods); revisions, revert, page settings and editors. Requires scopes: wikiread, wikiedit. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/wiki.

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

- `content` (string; required)
- `reason` (string; ≤ 256 characters)
- `previous` (string): Revision id the edit is based on (conflict detection)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/wiki/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "string",
    "reason": "string",
    "previous": "string"
  }'
```

Response 200:

```json
{
  "id": "string",
  "subreddit": "string",
  "page": "string",
  "content_md": "string",
  "revision_id": "string",
  "revision_by": "string",
  "revision_date": "2026-10-13T09:00:00.000Z",
  "reason": "string",
  "may_revise": true
}
```

## Reddit: Revisions (Wiki)

`POST /accounts/{accountId}/reddit/wiki/{itemId}/revisions`

Revisions. Read and edit subreddit wiki pages (including config/automoderator for mods); revisions, revert, page settings and editors. Requires scopes: wikiread. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/wiki.

Access: `write` · MCP tool: `reddit-wiki-revisions`

### 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/reddit/wiki/ITEM_ID/revisions" \
  -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
}
```

## Reddit: Revert to revision (Wiki)

`POST /accounts/{accountId}/reddit/wiki/{itemId}/revert`

Revert to revision. Read and edit subreddit wiki pages (including config/automoderator for mods); revisions, revert, page settings and editors. Destructive. Requires scopes: wikiread, modwiki. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/wiki.

Access: `write` · MCP tool: `reddit-wiki-revert`

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

- `revision` (string; required)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/wiki/ITEM_ID/revert" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "revision": "string"
  }'
```

Response 200:

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

## Reddit: Hide/unhide revision (Wiki)

`POST /accounts/{accountId}/reddit/wiki/{itemId}/hide-revision`

Hide/unhide revision. Read and edit subreddit wiki pages (including config/automoderator for mods); revisions, revert, page settings and editors. Requires scopes: wikiread, modwiki. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/wiki.

Access: `write` · MCP tool: `reddit-wiki-hide-revision`

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

- `revision` (string; required)

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

Response 200:

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

## Reddit: Page settings (Wiki)

`POST /accounts/{accountId}/reddit/wiki/{itemId}/settings`

Page settings. Read and edit subreddit wiki pages (including config/automoderator for mods); revisions, revert, page settings and editors. Requires scopes: wikiread, modwiki. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/wiki.

Access: `write` · MCP tool: `reddit-wiki-settings`

### 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/reddit/wiki/ITEM_ID/settings" \
  -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
}
```

## Reddit: Update page settings (Wiki)

`POST /accounts/{accountId}/reddit/wiki/{itemId}/update-settings`

Update page settings. Read and edit subreddit wiki pages (including config/automoderator for mods); revisions, revert, page settings and editors. Requires scopes: wikiread, modwiki. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/wiki.

Access: `write` · MCP tool: `reddit-wiki-update-settings`

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

- `permlevel` (integer; one of 0, 1, 2): 0 = subreddit settings, 1 = approved editors, 2 = mods only
- `listed` (boolean)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/wiki/ITEM_ID/update-settings" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "permlevel": 0,
    "listed": true
  }'
```

Response 200:

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

## Reddit: Allow editor (Wiki)

`POST /accounts/{accountId}/reddit/wiki/{itemId}/add-editor`

Allow editor. Read and edit subreddit wiki pages (including config/automoderator for mods); revisions, revert, page settings and editors. Requires scopes: wikiread, modwiki. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/wiki.

Access: `write` · MCP tool: `reddit-wiki-add-editor`

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

- `username` (string; required)

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

Response 200:

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

## Reddit: Remove editor (Wiki)

`POST /accounts/{accountId}/reddit/wiki/{itemId}/remove-editor`

Remove editor. Read and edit subreddit wiki pages (including config/automoderator for mods); revisions, revert, page settings and editors. Requires scopes: wikiread, modwiki. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/wiki.

Access: `write` · MCP tool: `reddit-wiki-remove-editor`

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

- `username` (string; required)

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

Response 200:

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

## Reddit: List Custom feeds

`GET /accounts/{accountId}/reddit/custom-feeds`

GET /api/multi/mine. Your multireddits (custom feeds). Cursor pagination: pass next_cursor back as cursor. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/custom-feeds.

Access: `read` · MCP tool: `reddit-custom-feeds-list`

### Path parameters

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

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "display_name": "string",
      "path": "string",
      "description": "string",
      "visibility": "private",
      "subreddits": [
        "string"
      ],
      "over_18": true,
      "icon_url": "https://example.com",
      "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"
}
```

## Reddit: Create a Custom feeds item

`POST /accounts/{accountId}/reddit/custom-feeds`

POST /api/multi/{multipath}. Your multireddits (custom feeds). Requires scopes: read, subscribe. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/custom-feeds.

Access: `write` · MCP tool: `reddit-custom-feeds-create`

### Path parameters

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

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `name` (string; required; pattern ^[A-Za-z0-9_]{2,50}$): URL name
- `display_name` (string; ≤ 50 characters)
- `description` (string)
- `visibility` (string; one of private, public, hidden)
- `subreddits` (array of string)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/custom-feeds" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "display_name": "string",
    "description": "string",
    "visibility": "private",
    "subreddits": [
      "string"
    ]
  }'
```

Response 201:

```json
{
  "id": "string",
  "name": "string",
  "display_name": "string",
  "path": "string",
  "description": "string",
  "visibility": "private",
  "subreddits": [
    "string"
  ],
  "over_18": true,
  "icon_url": "https://example.com",
  "created_at": "2026-10-13T09:00:00.000Z"
}
```

## Reddit: Get a Custom feeds item

`GET /accounts/{accountId}/reddit/custom-feeds/{itemId}`

GET /api/multi/{multipath}. Your multireddits (custom feeds). Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/custom-feeds.

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

Response 200:

```json
{
  "id": "string",
  "name": "string",
  "display_name": "string",
  "path": "string",
  "description": "string",
  "visibility": "private",
  "subreddits": [
    "string"
  ],
  "over_18": true,
  "icon_url": "https://example.com",
  "created_at": "2026-10-13T09:00:00.000Z"
}
```

## Reddit: Update a Custom feeds item

`PATCH /accounts/{accountId}/reddit/custom-feeds/{itemId}`

PUT /api/multi/{multipath}. Your multireddits (custom feeds). Requires scopes: read, subscribe. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/custom-feeds.

Access: `write` · MCP tool: `reddit-custom-feeds-update`

### Path parameters

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

### Body

- `name` (string; pattern ^[A-Za-z0-9_]{2,50}$): URL name
- `display_name` (string; ≤ 50 characters)
- `description` (string)
- `visibility` (string; one of private, public, hidden)
- `subreddits` (array of string)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/custom-feeds/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "display_name": "string",
    "description": "string",
    "visibility": "private",
    "subreddits": [
      "string"
    ]
  }'
```

Response 200:

```json
{
  "id": "string",
  "name": "string",
  "display_name": "string",
  "path": "string",
  "description": "string",
  "visibility": "private",
  "subreddits": [
    "string"
  ],
  "over_18": true,
  "icon_url": "https://example.com",
  "created_at": "2026-10-13T09:00:00.000Z"
}
```

## Reddit: Delete a Custom feeds item

`DELETE /accounts/{accountId}/reddit/custom-feeds/{itemId}`

DELETE /api/multi/{multipath}. Your multireddits (custom feeds). Requires scopes: read, subscribe. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/custom-feeds.

Access: `write` · MCP tool: `reddit-custom-feeds-delete`

### Path parameters

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

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

Response 200:

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

## Reddit: Add subreddit (Custom feeds)

`POST /accounts/{accountId}/reddit/custom-feeds/{itemId}/add-subreddit`

Add subreddit. Your multireddits (custom feeds). Requires scopes: read, subscribe. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/custom-feeds.

Access: `write` · MCP tool: `reddit-custom-feeds-add-subreddit`

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

- `subreddit` (string; required; ≥ 1 characters): Subreddit name without r/

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

Response 200:

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

## Reddit: Remove subreddit (Custom feeds)

`POST /accounts/{accountId}/reddit/custom-feeds/{itemId}/remove-subreddit`

Remove subreddit. Your multireddits (custom feeds). Requires scopes: read, subscribe. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/custom-feeds.

Access: `write` · MCP tool: `reddit-custom-feeds-remove-subreddit`

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

- `subreddit` (string; required; ≥ 1 characters): Subreddit name without r/

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

Response 200:

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

## Reddit: List Inbox

`GET /accounts/{accountId}/reddit/inbox`

GET /message/inbox. Everything: messages, replies to your posts and comments, and username mentions. Cursor pagination: pass next_cursor back as cursor. Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/inbox.

Access: `read` · MCP tool: `reddit-inbox-list`

### Path parameters

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

### Query parameters

- `cursor` (string): Pagination cursor (Reddit after fullname)
- `limit` (integer; 1–100)
- `filter` (string; one of inbox, unread, messages, comments, selfreply, mentions)
- `mark_read` (boolean)

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "type": "message",
      "subject": "string",
      "text": "string",
      "author": "string",
      "to": "+15551234567",
      "created_at": "2026-10-13T09:00:00.000Z",
      "unread": true,
      "direction": "in",
      "conversation_id": "string",
      "parent_id": "string",
      "post_id": "string",
      "post_title": "string",
      "subreddit": "string",
      "permalink": "https://example.com",
      "distinguished": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Reddit: Reply (Inbox)

`POST /accounts/{accountId}/reddit/inbox/{itemId}/reply`

Reply. Everything: messages, replies to your posts and comments, and username mentions. Requires scopes: privatemessages, submit. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/inbox.

Access: `write` · MCP tool: `reddit-inbox-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; ≥ 1 characters)

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

Response 200:

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

## Reddit: Mark read (Inbox)

`POST /accounts/{accountId}/reddit/inbox/{itemId}/mark-read`

Mark read. Everything: messages, replies to your posts and comments, and username mentions. Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/inbox.

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

## Reddit: Mark all read (Inbox)

`POST /accounts/{accountId}/reddit/inbox/mark-all-read`

Mark all read. Everything: messages, replies to your posts and comments, and username mentions. Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/inbox.

Access: `write` · MCP tool: `reddit-inbox-mark-all-read`

### Path parameters

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

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/inbox/mark-all-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
}
```

## Reddit: Delete message (Inbox)

`POST /accounts/{accountId}/reddit/inbox/{itemId}/delete`

POST /api/del_msg (private messages only; removes it from your view). Everything: messages, replies to your posts and comments, and username mentions. Destructive. Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/inbox.

Access: `write` · MCP tool: `reddit-inbox-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 POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/inbox/ITEM_ID/delete" \
  -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
}
```

## Reddit: List Messages

`GET /accounts/{accountId}/reddit/messages`

GET /message/messages (+ /message/sent). Private message threads (delivered as Reddit Chat since 2025). Text only; never send unsolicited messages. Cursor pagination: pass next_cursor back as cursor. Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/messages.

Access: `read` · MCP tool: `reddit-messages-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 (Reddit after fullname)
- `limit` (integer; 1–100)
- `include_sent` (boolean)

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

Response 200:

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

## Reddit: Create a Messages item

`POST /accounts/{accountId}/reddit/messages`

POST /api/compose (new conversation; recipient may need to accept a chat request). Private message threads (delivered as Reddit Chat since 2025). Text only; never send unsolicited messages. Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/messages.

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

### Path parameters

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

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `to` (string; required): username, u/username, or r/subreddit (messages its moderators)
- `subject` (string; ≤ 100 characters)
- `text` (string; required; ≥ 1 characters)
- `from_subreddit` (string): Send as a subreddit you moderate

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

Response 201:

```json
{
  "id": "string",
  "subject": "string",
  "updated_at": "2026-10-13T09:00:00.000Z",
  "unread_count": 1,
  "last_message": "string",
  "message_count": 1,
  "participants": [
    {
      "id": "string",
      "name": "string",
      "username": "string",
      "subreddit": "string"
    }
  ],
  "messages": [
    {
      "id": "string",
      "text": "string",
      "direction": "in",
      "sent_at": "2026-10-13T09:00:00.000Z",
      "from_id": "string",
      "to_id": "string",
      "subject": "string",
      "unread": true
    }
  ]
}
```

## Reddit: Get a Messages item

`GET /accounts/{accountId}/reddit/messages/{itemId}`

GET /message/messages/{id}. Private message threads (delivered as Reddit Chat since 2025). Text only; never send unsolicited messages. Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/messages.

Access: `read` · MCP tool: `reddit-messages-get` · Zernio: `GET /v1/inbox/conversations/{conversationId}`

### Path parameters

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

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

Response 200:

```json
{
  "id": "string",
  "subject": "string",
  "updated_at": "2026-10-13T09:00:00.000Z",
  "unread_count": 1,
  "last_message": "string",
  "message_count": 1,
  "participants": [
    {
      "id": "string",
      "name": "string",
      "username": "string",
      "subreddit": "string"
    }
  ],
  "messages": [
    {
      "id": "string",
      "text": "string",
      "direction": "in",
      "sent_at": "2026-10-13T09:00:00.000Z",
      "from_id": "string",
      "to_id": "string",
      "subject": "string",
      "unread": true
    }
  ]
}
```

## Reddit: Delete a Messages item

`DELETE /accounts/{accountId}/reddit/messages/{itemId}`

POST /api/del_msg. Private message threads (delivered as Reddit Chat since 2025). Text only; never send unsolicited messages. Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/messages.

Access: `write` · MCP tool: `reddit-messages-delete` · 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

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

Response 200:

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

## Reddit: Reply (Messages)

`POST /accounts/{accountId}/reddit/messages/{itemId}/reply`

Reply. Private message threads (delivered as Reddit Chat since 2025). Text only; never send unsolicited messages. Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/messages.

Access: `write` · MCP tool: `reddit-messages-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; ≥ 1 characters)

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

Response 200:

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

## Reddit: Mark read (Messages)

`POST /accounts/{accountId}/reddit/messages/{itemId}/mark-read`

Mark read. Private message threads (delivered as Reddit Chat since 2025). Text only; never send unsolicited messages. Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/messages.

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

## Reddit: Mark all read (Messages)

`POST /accounts/{accountId}/reddit/messages/mark-all-read`

Mark all read. Private message threads (delivered as Reddit Chat since 2025). Text only; never send unsolicited messages. Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/messages.

Access: `write` · MCP tool: `reddit-messages-mark-all-read`

### Path parameters

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

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/messages/mark-all-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
}
```

## Reddit: List Mentions

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

GET /message/mentions. Comments that mention u/you. Cursor pagination: pass next_cursor back as cursor. Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mentions.

Access: `read` · MCP tool: `reddit-mentions-list`

### Path parameters

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

### Query parameters

- `cursor` (string): Pagination cursor (Reddit after fullname)
- `limit` (integer; 1–100)
- `mark_read` (boolean)

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "type": "message",
      "subject": "string",
      "text": "string",
      "author": "string",
      "to": "+15551234567",
      "created_at": "2026-10-13T09:00:00.000Z",
      "unread": true,
      "direction": "in",
      "conversation_id": "string",
      "parent_id": "string",
      "post_id": "string",
      "post_title": "string",
      "subreddit": "string",
      "permalink": "https://example.com",
      "distinguished": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Reddit: Reply (Mentions)

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

Reply. Comments that mention u/you. Requires scopes: privatemessages, submit. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mentions.

Access: `write` · MCP tool: `reddit-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; ≥ 1 characters)

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

Response 200:

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

## Reddit: Mark read (Mentions)

`POST /accounts/{accountId}/reddit/mentions/{itemId}/mark-read`

Mark read. Comments that mention u/you. Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mentions.

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

## Reddit: Mark all read (Mentions)

`POST /accounts/{accountId}/reddit/mentions/mark-all-read`

Mark all read. Comments that mention u/you. Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mentions.

Access: `write` · MCP tool: `reddit-mentions-mark-all-read`

### Path parameters

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

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/mentions/mark-all-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
}
```

## Reddit: Vote (Mentions)

`POST /accounts/{accountId}/reddit/mentions/{itemId}/vote`

Upvote (1), downvote (-1) or clear (0). Human click only; never automate or batch. Comments that mention u/you. Requires scopes: privatemessages, vote. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mentions.

Access: `write` · MCP tool: `reddit-mentions-vote`

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

- `direction` (integer; required; one of 1, 0, -1)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/mentions/ITEM_ID/vote" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "direction": 1
  }'
```

Response 200:

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

## Reddit: Save (Mentions)

`POST /accounts/{accountId}/reddit/mentions/{itemId}/save`

Save. Comments that mention u/you. Requires scopes: privatemessages, save. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mentions.

Access: `write` · MCP tool: `reddit-mentions-save`

### Path parameters

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

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `category` (string): Saved category (Reddit Premium)

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

Response 200:

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

## Reddit: Unsave (Mentions)

`POST /accounts/{accountId}/reddit/mentions/{itemId}/unsave`

Unsave. Comments that mention u/you. Requires scopes: privatemessages, save. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mentions.

Access: `write` · MCP tool: `reddit-mentions-unsave`

### 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/reddit/mentions/ITEM_ID/unsave" \
  -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
}
```

## Reddit: Report (Mentions)

`POST /accounts/{accountId}/reddit/mentions/{itemId}/report`

Report. Comments that mention u/you. Requires scopes: privatemessages, report. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mentions.

Access: `write` · MCP tool: `reddit-mentions-report`

### Path parameters

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

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `reason` (string; ≤ 100 characters): Reason text
- `rule_reason` (string): Subreddit rule short_name
- `site_reason` (string): Site-wide rule
- `custom_text` (string; ≤ 2000 characters)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/mentions/ITEM_ID/report" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "reason": "string",
    "rule_reason": "string",
    "site_reason": "string",
    "custom_text": "string"
  }'
```

Response 200:

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

## Reddit: List Replies

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

GET /message/comments. Replies to your comments (comments) and to your posts (selfreply). Cursor pagination: pass next_cursor back as cursor. Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/replies.

Access: `read` · MCP tool: `reddit-replies-list`

### Path parameters

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

### Query parameters

- `cursor` (string): Pagination cursor (Reddit after fullname)
- `limit` (integer; 1–100)
- `filter` (string; one of comments, selfreply)
- `mark_read` (boolean)

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "type": "message",
      "subject": "string",
      "text": "string",
      "author": "string",
      "to": "+15551234567",
      "created_at": "2026-10-13T09:00:00.000Z",
      "unread": true,
      "direction": "in",
      "conversation_id": "string",
      "parent_id": "string",
      "post_id": "string",
      "post_title": "string",
      "subreddit": "string",
      "permalink": "https://example.com",
      "distinguished": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Reddit: Reply (Replies)

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

Reply. Replies to your comments (comments) and to your posts (selfreply). Requires scopes: privatemessages, submit. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/replies.

Access: `write` · MCP tool: `reddit-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; ≥ 1 characters)

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

Response 200:

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

## Reddit: Mark read (Replies)

`POST /accounts/{accountId}/reddit/replies/{itemId}/mark-read`

Mark read. Replies to your comments (comments) and to your posts (selfreply). Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/replies.

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

## Reddit: Mark all read (Replies)

`POST /accounts/{accountId}/reddit/replies/mark-all-read`

Mark all read. Replies to your comments (comments) and to your posts (selfreply). Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/replies.

Access: `write` · MCP tool: `reddit-replies-mark-all-read`

### Path parameters

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

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/replies/mark-all-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
}
```

## Reddit: Vote (Replies)

`POST /accounts/{accountId}/reddit/replies/{itemId}/vote`

Upvote (1), downvote (-1) or clear (0). Human click only; never automate or batch. Replies to your comments (comments) and to your posts (selfreply). Requires scopes: privatemessages, vote. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/replies.

Access: `write` · MCP tool: `reddit-replies-vote`

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

- `direction` (integer; required; one of 1, 0, -1)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/replies/ITEM_ID/vote" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "direction": 1
  }'
```

Response 200:

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

## Reddit: Save (Replies)

`POST /accounts/{accountId}/reddit/replies/{itemId}/save`

Save. Replies to your comments (comments) and to your posts (selfreply). Requires scopes: privatemessages, save. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/replies.

Access: `write` · MCP tool: `reddit-replies-save`

### Path parameters

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

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `category` (string): Saved category (Reddit Premium)

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

Response 200:

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

## Reddit: Unsave (Replies)

`POST /accounts/{accountId}/reddit/replies/{itemId}/unsave`

Unsave. Replies to your comments (comments) and to your posts (selfreply). Requires scopes: privatemessages, save. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/replies.

Access: `write` · MCP tool: `reddit-replies-unsave`

### 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/reddit/replies/ITEM_ID/unsave" \
  -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
}
```

## Reddit: Report (Replies)

`POST /accounts/{accountId}/reddit/replies/{itemId}/report`

Report. Replies to your comments (comments) and to your posts (selfreply). Requires scopes: privatemessages, report. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/replies.

Access: `write` · MCP tool: `reddit-replies-report`

### Path parameters

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

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `reason` (string; ≤ 100 characters): Reason text
- `rule_reason` (string): Subreddit rule short_name
- `site_reason` (string): Site-wide rule
- `custom_text` (string; ≤ 2000 characters)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/replies/ITEM_ID/report" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "reason": "string",
    "rule_reason": "string",
    "site_reason": "string",
    "custom_text": "string"
  }'
```

Response 200:

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

## Reddit: List Sent

`GET /accounts/{accountId}/reddit/sent`

GET /message/sent. Cursor pagination: pass next_cursor back as cursor. Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/sent.

Access: `read` · MCP tool: `reddit-sent-list`

### Path parameters

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

### Query parameters

- `cursor` (string): Pagination cursor (Reddit after fullname)
- `limit` (integer; 1–100)

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "type": "message",
      "subject": "string",
      "text": "string",
      "author": "string",
      "to": "+15551234567",
      "created_at": "2026-10-13T09:00:00.000Z",
      "unread": true,
      "direction": "in",
      "conversation_id": "string",
      "parent_id": "string",
      "post_id": "string",
      "post_title": "string",
      "subreddit": "string",
      "permalink": "https://example.com",
      "distinguished": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Reddit: List Reddit announcements

`GET /accounts/{accountId}/reddit/announcements`

GET /api/announcements/v1[/unread]. Admin notices delivered to the inbox (response shape unverified). Cursor pagination: pass next_cursor back as cursor. Requires scopes: announcements. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/announcements.

Access: `read` · MCP tool: `reddit-announcements-list`

### Path parameters

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

### Query parameters

- `cursor` (string): Pagination cursor (Reddit after fullname)
- `limit` (integer; 1–100)
- `unread` (boolean)

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "title": "string",
      "body": "string",
      "url": "https://example.com",
      "sent_at": "2026-10-13T09:00:00.000Z",
      "read": true,
      "hidden": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Reddit: Mark read (Reddit announcements)

`POST /accounts/{accountId}/reddit/announcements/{itemId}/read`

Mark read. Admin notices delivered to the inbox (response shape unverified). Requires scopes: announcements. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/announcements.

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

## Reddit: Hide (Reddit announcements)

`POST /accounts/{accountId}/reddit/announcements/{itemId}/hide`

Hide. Admin notices delivered to the inbox (response shape unverified). Requires scopes: announcements. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/announcements.

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

## Reddit: Mark all read (Reddit announcements)

`POST /accounts/{accountId}/reddit/announcements/read-all`

Mark all read. Admin notices delivered to the inbox (response shape unverified). Requires scopes: announcements. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/announcements.

Access: `write` · MCP tool: `reddit-announcements-read-all`

### Path parameters

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

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/announcements/read-all" \
  -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
}
```

## Reddit: List Moderated subreddits

`GET /accounts/{accountId}/reddit/moderated-subreddits`

GET /subreddits/mine/moderator. Communities you moderate. Moderation resources act on one of these. Cursor pagination: pass next_cursor back as cursor. Requires scopes: mysubreddits. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/moderated-subreddits.

Access: `read` · MCP tool: `reddit-moderated-subreddits-list`

### Path parameters

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

### Query parameters

- `cursor` (string): Pagination cursor (Reddit after fullname)
- `limit` (integer; 1–100)

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "prefixed_name": "string",
      "title": "string",
      "description": "string",
      "subscribers": 1,
      "active_users": 1,
      "type": "public",
      "over_18": true,
      "submission_type": "any",
      "post_types": {
        "self": true,
        "link": true,
        "image": true,
        "video": true,
        "gallery": true,
        "videogif": true
      },
      "spoilers_enabled": true,
      "link_flair_enabled": true,
      "restrict_posting": true,
      "user_is_subscriber": true,
      "user_is_moderator": true,
      "user_is_contributor": true,
      "user_is_banned": true,
      "icon_url": "https://example.com",
      "banner_url": "https://example.com",
      "url": "https://example.com",
      "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"
}
```

## Reddit: Leave as moderator (Moderated subreddits)

`POST /accounts/{accountId}/reddit/moderated-subreddits/{itemId}/leave`

Leave as moderator. Communities you moderate. Moderation resources act on one of these. Destructive. Requires scopes: mysubreddits, modself. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/moderated-subreddits.

Access: `write` · MCP tool: `reddit-moderated-subreddits-leave`

### 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/reddit/moderated-subreddits/ITEM_ID/leave" \
  -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
}
```

## Reddit: Leave as approved user (Moderated subreddits)

`POST /accounts/{accountId}/reddit/moderated-subreddits/{itemId}/leave-contributor`

Leave as approved user. Communities you moderate. Moderation resources act on one of these. Destructive. Requires scopes: mysubreddits, modself. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/moderated-subreddits.

Access: `write` · MCP tool: `reddit-moderated-subreddits-leave-contributor`

### 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/reddit/moderated-subreddits/ITEM_ID/leave-contributor" \
  -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
}
```

## Reddit: Accept moderator invite (Moderated subreddits)

`POST /accounts/{accountId}/reddit/moderated-subreddits/accept-invite`

Accept moderator invite. Communities you moderate. Moderation resources act on one of these. Requires scopes: mysubreddits, modself. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/moderated-subreddits.

Access: `write` · MCP tool: `reddit-moderated-subreddits-accept-invite`

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

- `subreddit` (string; required; ≥ 1 characters): Subreddit name without r/

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/moderated-subreddits/accept-invite" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "subreddit": "string"
  }'
```

Response 200:

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

## Reddit: List Mod queue

`GET /accounts/{accountId}/reddit/mod-queue`

GET /r/{sr}/about/{modqueue|reports|spam|edited|unmoderated}. Mod queue, reports, spam, edited and unmoderated items. Use subreddit "mod" for all your communities. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mod-queue.

Access: `read` · MCP tool: `reddit-mod-queue-list`

### Path parameters

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

### Query parameters

- `cursor` (string): Pagination cursor (Reddit after fullname)
- `limit` (integer; 1–100)
- `subreddit` (string): Subreddit, or "mod" for all moderated
- `location` (string; one of modqueue, reports, spam, edited, unmoderated)
- `only` (string; one of links, comments)

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "short_id": "string",
      "title": "string",
      "text": "string",
      "url": "https://example.com",
      "permalink": "https://example.com",
      "subreddit": "string",
      "author": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "edited_at": "2026-10-13T09:00:00.000Z",
      "score": 1,
      "upvote_ratio": 0,
      "num_comments": 1,
      "num_crossposts": 1,
      "awards": 1,
      "view_count": 1,
      "kind": "post",
      "domain": "string",
      "thumbnail": "https://example.com",
      "flair_text": "string",
      "flair_template_id": "string",
      "over_18": true,
      "spoiler": true,
      "locked": true,
      "stickied": true,
      "archived": true,
      "distinguished": "string",
      "send_replies": true,
      "saved": true,
      "hidden": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Reddit: Approve (Mod queue)

`POST /accounts/{accountId}/reddit/mod-queue/{itemId}/approve`

Approve. Mod queue, reports, spam, edited and unmoderated items. Use subreddit "mod" for all your communities. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mod-queue.

Access: `write` · MCP tool: `reddit-mod-queue-approve`

### 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/reddit/mod-queue/ITEM_ID/approve" \
  -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
}
```

## Reddit: Remove (Mod queue)

`POST /accounts/{accountId}/reddit/mod-queue/{itemId}/remove`

Remove. Mod queue, reports, spam, edited and unmoderated items. Use subreddit "mod" for all your communities. Destructive. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mod-queue.

Access: `write` · MCP tool: `reddit-mod-queue-remove`

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

- `spam` (boolean)
- `reason_id` (string): Removal reason id
- `mod_note` (string; ≤ 100 characters): Private note for the mod log

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/mod-queue/ITEM_ID/remove" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "spam": false,
    "reason_id": "string",
    "mod_note": "string"
  }'
```

Response 200:

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

## Reddit: Send removal message (Mod queue)

`POST /accounts/{accountId}/reddit/mod-queue/{itemId}/send-removal-message`

Send removal message. Mod queue, reports, spam, edited and unmoderated items. Use subreddit "mod" for all your communities. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mod-queue.

Access: `write` · MCP tool: `reddit-mod-queue-send-removal-message`

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

- `message` (string; required; ≥ 1 characters)
- `type` (string; one of public, private, private_exposed)
- `title` (string; ≤ 50 characters): Subject (private messages)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/mod-queue/ITEM_ID/send-removal-message" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "string",
    "type": "public",
    "title": "string"
  }'
```

Response 200:

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

## Reddit: Distinguish (Mod queue)

`POST /accounts/{accountId}/reddit/mod-queue/{itemId}/distinguish`

Distinguish. Mod queue, reports, spam, edited and unmoderated items. Use subreddit "mod" for all your communities. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mod-queue.

Access: `write` · MCP tool: `reddit-mod-queue-distinguish`

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

- `how` (string; one of yes, no, admin, special)
- `sticky` (boolean): Sticky (top-level own comments only)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/mod-queue/ITEM_ID/distinguish" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "how": "yes",
    "sticky": true
  }'
```

Response 200:

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

## Reddit: Ignore reports (Mod queue)

`POST /accounts/{accountId}/reddit/mod-queue/{itemId}/ignore-reports`

Ignore reports. Mod queue, reports, spam, edited and unmoderated items. Use subreddit "mod" for all your communities. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mod-queue.

Access: `write` · MCP tool: `reddit-mod-queue-ignore-reports`

### 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/reddit/mod-queue/ITEM_ID/ignore-reports" \
  -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
}
```

## Reddit: Unignore reports (Mod queue)

`POST /accounts/{accountId}/reddit/mod-queue/{itemId}/unignore-reports`

Unignore reports. Mod queue, reports, spam, edited and unmoderated items. Use subreddit "mod" for all your communities. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mod-queue.

Access: `write` · MCP tool: `reddit-mod-queue-unignore-reports`

### 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/reddit/mod-queue/ITEM_ID/unignore-reports" \
  -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
}
```

## Reddit: Snooze reports (Mod queue)

`POST /accounts/{accountId}/reddit/mod-queue/{itemId}/snooze-reports`

Snooze reports. Mod queue, reports, spam, edited and unmoderated items. Use subreddit "mod" for all your communities. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mod-queue.

Access: `write` · MCP tool: `reddit-mod-queue-snooze-reports`

### Path parameters

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

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `reason` (string; required): Report reason to snooze for 7 days

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/mod-queue/ITEM_ID/snooze-reports" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "reason": "string"
  }'
```

Response 200:

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

## Reddit: Unsnooze reports (Mod queue)

`POST /accounts/{accountId}/reddit/mod-queue/{itemId}/unsnooze-reports`

Unsnooze reports. Mod queue, reports, spam, edited and unmoderated items. Use subreddit "mod" for all your communities. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mod-queue.

Access: `write` · MCP tool: `reddit-mod-queue-unsnooze-reports`

### Path parameters

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

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `reason` (string; required)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/mod-queue/ITEM_ID/unsnooze-reports" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "reason": "string"
  }'
```

Response 200:

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

## Reddit: Lock (Mod queue)

`POST /accounts/{accountId}/reddit/mod-queue/{itemId}/lock`

Lock. Mod queue, reports, spam, edited and unmoderated items. Use subreddit "mod" for all your communities. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mod-queue.

Access: `write` · MCP tool: `reddit-mod-queue-lock`

### 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/reddit/mod-queue/ITEM_ID/lock" \
  -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
}
```

## Reddit: Unlock (Mod queue)

`POST /accounts/{accountId}/reddit/mod-queue/{itemId}/unlock`

Unlock. Mod queue, reports, spam, edited and unmoderated items. Use subreddit "mod" for all your communities. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mod-queue.

Access: `write` · MCP tool: `reddit-mod-queue-unlock`

### 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/reddit/mod-queue/ITEM_ID/unlock" \
  -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
}
```

## Reddit: Mark NSFW (Mod queue)

`POST /accounts/{accountId}/reddit/mod-queue/{itemId}/mark-nsfw`

Mark NSFW. Mod queue, reports, spam, edited and unmoderated items. Use subreddit "mod" for all your communities. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mod-queue.

Access: `write` · MCP tool: `reddit-mod-queue-mark-nsfw`

### 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/reddit/mod-queue/ITEM_ID/mark-nsfw" \
  -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
}
```

## Reddit: Unmark NSFW (Mod queue)

`POST /accounts/{accountId}/reddit/mod-queue/{itemId}/unmark-nsfw`

Unmark NSFW. Mod queue, reports, spam, edited and unmoderated items. Use subreddit "mod" for all your communities. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mod-queue.

Access: `write` · MCP tool: `reddit-mod-queue-unmark-nsfw`

### 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/reddit/mod-queue/ITEM_ID/unmark-nsfw" \
  -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
}
```

## Reddit: Mark spoiler (Mod queue)

`POST /accounts/{accountId}/reddit/mod-queue/{itemId}/spoiler`

Mark spoiler. Mod queue, reports, spam, edited and unmoderated items. Use subreddit "mod" for all your communities. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mod-queue.

Access: `write` · MCP tool: `reddit-mod-queue-spoiler`

### 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/reddit/mod-queue/ITEM_ID/spoiler" \
  -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
}
```

## Reddit: Unmark spoiler (Mod queue)

`POST /accounts/{accountId}/reddit/mod-queue/{itemId}/unspoiler`

Unmark spoiler. Mod queue, reports, spam, edited and unmoderated items. Use subreddit "mod" for all your communities. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mod-queue.

Access: `write` · MCP tool: `reddit-mod-queue-unspoiler`

### 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/reddit/mod-queue/ITEM_ID/unspoiler" \
  -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
}
```

## Reddit: Pin / unpin (Mod queue)

`POST /accounts/{accountId}/reddit/mod-queue/{itemId}/sticky`

Pin / unpin. Mod queue, reports, spam, edited and unmoderated items. Use subreddit "mod" for all your communities. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mod-queue.

Access: `write` · MCP tool: `reddit-mod-queue-sticky`

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

- `state` (boolean)
- `num` (integer; 1–6): Highlight slot (1–6)
- `to_profile` (boolean)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/mod-queue/ITEM_ID/sticky" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "state": true,
    "num": 1,
    "to_profile": true
  }'
```

Response 200:

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

## Reddit: Contest mode (Mod queue)

`POST /accounts/{accountId}/reddit/mod-queue/{itemId}/contest-mode`

Contest mode. Mod queue, reports, spam, edited and unmoderated items. Use subreddit "mod" for all your communities. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mod-queue.

Access: `write` · MCP tool: `reddit-mod-queue-contest-mode`

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

- `state` (boolean)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/mod-queue/ITEM_ID/contest-mode" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "state": true
  }'
```

Response 200:

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

## Reddit: Suggested sort (Mod queue)

`POST /accounts/{accountId}/reddit/mod-queue/{itemId}/suggested-sort`

Suggested sort. Mod queue, reports, spam, edited and unmoderated items. Use subreddit "mod" for all your communities. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mod-queue.

Access: `write` · MCP tool: `reddit-mod-queue-suggested-sort`

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

- `sort` (string; required; one of confidence, top, new, controversial, old, random, qa, live, blank)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/mod-queue/ITEM_ID/suggested-sort" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "sort": "confidence"
  }'
```

Response 200:

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

## Reddit: Crowd control level (Mod queue)

`POST /accounts/{accountId}/reddit/mod-queue/{itemId}/crowd-control`

Crowd control level. Mod queue, reports, spam, edited and unmoderated items. Use subreddit "mod" for all your communities. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mod-queue.

Access: `write` · MCP tool: `reddit-mod-queue-crowd-control`

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

- `level` (integer; required; 0–3)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/mod-queue/ITEM_ID/crowd-control" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "level": 0
  }'
```

Response 200:

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

## Reddit: List Mod log

`GET /accounts/{accountId}/reddit/mod-log`

GET /r/{sr}/about/log. Cursor pagination: pass next_cursor back as cursor. Requires scopes: modlog. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mod-log.

Access: `read` · MCP tool: `reddit-mod-log-list`

### Path parameters

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

### Query parameters

- `cursor` (string): Pagination cursor (Reddit after fullname)
- `limit` (integer; 1–100)
- `subreddit` (string)
- `type` (string): Action type, e.g. removelink, banuser, approvecomment
- `mod` (string): Moderator username (comma-separated)

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "action": "string",
      "mod": "string",
      "subreddit": "string",
      "target_fullname": "string",
      "target_author": "string",
      "target_title": "string",
      "target_body": "string",
      "target_permalink": "https://example.com",
      "details": "string",
      "description": "string",
      "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"
}
```

## Reddit: List Modmail

`GET /accounts/{accountId}/reddit/modmail`

GET /api/mod/conversations. New modmail conversations for your communities (replies reach users via Reddit Chat). Cursor pagination: pass next_cursor back as cursor. Requires scopes: modmail. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/modmail.

Access: `read` · MCP tool: `reddit-modmail-list`

### Path parameters

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

### Query parameters

- `cursor` (string): Pagination cursor (Reddit after fullname)
- `limit` (integer; 1–100)
- `state` (string; one of all, appeals, notifications, inbox, filtered, inprogress, mod, archived, default, highlighted, join_requests, new)
- `subreddits` (string): Comma-separated subreddits (default: all)
- `sort` (string; one of recent, mod, user, unread)

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "subject": "string",
      "subreddit": "string",
      "state": 1,
      "is_highlighted": true,
      "is_internal": true,
      "is_appeal": true,
      "num_messages": 1,
      "participant": "string",
      "authors": [
        "string"
      ],
      "last_updated": "2026-10-13T09:00:00.000Z",
      "unread": true,
      "last_message": "string",
      "messages": [
        {
          "id": "string",
          "text": "string",
          "author": "string",
          "author_is_mod": true,
          "author_hidden": true,
          "is_internal": true
        }
      ]
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Reddit: Create a Modmail item

`POST /accounts/{accountId}/reddit/modmail`

POST /api/mod/conversations. New modmail conversations for your communities (replies reach users via Reddit Chat). Requires scopes: modmail. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/modmail.

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

- `subreddit` (string; required; ≥ 1 characters): Subreddit name without r/
- `to` (string): username (omit for a mod discussion)
- `subject` (string; required; ≤ 100 characters)
- `body` (string; required; ≥ 1 characters)
- `is_author_hidden` (boolean)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/modmail" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "subreddit": "string",
    "to": "+15551234567",
    "subject": "string",
    "body": "string",
    "is_author_hidden": false
  }'
```

Response 201:

```json
{
  "id": "string",
  "subject": "string",
  "subreddit": "string",
  "state": 1,
  "is_highlighted": true,
  "is_internal": true,
  "is_appeal": true,
  "num_messages": 1,
  "participant": "string",
  "authors": [
    "string"
  ],
  "last_updated": "2026-10-13T09:00:00.000Z",
  "unread": true,
  "last_message": "string",
  "messages": [
    {
      "id": "string",
      "text": "string",
      "author": "string",
      "author_is_mod": true,
      "author_hidden": true,
      "is_internal": true,
      "sent_at": "2026-10-13T09:00:00.000Z",
      "direction": "in"
    }
  ]
}
```

## Reddit: Get a Modmail item

`GET /accounts/{accountId}/reddit/modmail/{itemId}`

GET /api/mod/conversations/{id}. New modmail conversations for your communities (replies reach users via Reddit Chat). Requires scopes: modmail. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/modmail.

Access: `read` · MCP tool: `reddit-modmail-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

### Query parameters

- `mark_read` (boolean)

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

Response 200:

```json
{
  "id": "string",
  "subject": "string",
  "subreddit": "string",
  "state": 1,
  "is_highlighted": true,
  "is_internal": true,
  "is_appeal": true,
  "num_messages": 1,
  "participant": "string",
  "authors": [
    "string"
  ],
  "last_updated": "2026-10-13T09:00:00.000Z",
  "unread": true,
  "last_message": "string",
  "messages": [
    {
      "id": "string",
      "text": "string",
      "author": "string",
      "author_is_mod": true,
      "author_hidden": true,
      "is_internal": true,
      "sent_at": "2026-10-13T09:00:00.000Z",
      "direction": "in"
    }
  ]
}
```

## Reddit: Reply (Modmail)

`POST /accounts/{accountId}/reddit/modmail/{itemId}/reply`

Reply. New modmail conversations for your communities (replies reach users via Reddit Chat). Requires scopes: modmail. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/modmail.

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

- `body` (string; required; ≥ 1 characters)
- `is_internal` (boolean): Private moderator note
- `is_author_hidden` (boolean): Reply as the subreddit

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/modmail/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "body": "string",
    "is_internal": false,
    "is_author_hidden": false
  }'
```

Response 200:

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

## Reddit: Archive (Modmail)

`POST /accounts/{accountId}/reddit/modmail/{itemId}/archive`

Archive. New modmail conversations for your communities (replies reach users via Reddit Chat). Requires scopes: modmail. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/modmail.

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

## Reddit: Unarchive (Modmail)

`POST /accounts/{accountId}/reddit/modmail/{itemId}/unarchive`

Unarchive. New modmail conversations for your communities (replies reach users via Reddit Chat). Requires scopes: modmail. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/modmail.

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

## Reddit: Highlight (Modmail)

`POST /accounts/{accountId}/reddit/modmail/{itemId}/highlight`

Highlight. New modmail conversations for your communities (replies reach users via Reddit Chat). Requires scopes: modmail. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/modmail.

Access: `write` · MCP tool: `reddit-modmail-highlight`

### 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/reddit/modmail/ITEM_ID/highlight" \
  -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
}
```

## Reddit: Remove highlight (Modmail)

`POST /accounts/{accountId}/reddit/modmail/{itemId}/unhighlight`

Remove highlight. New modmail conversations for your communities (replies reach users via Reddit Chat). Requires scopes: modmail. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/modmail.

Access: `write` · MCP tool: `reddit-modmail-unhighlight`

### 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/reddit/modmail/ITEM_ID/unhighlight" \
  -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
}
```

## Reddit: Mark read (Modmail)

`POST /accounts/{accountId}/reddit/modmail/{itemId}/read`

Mark read. New modmail conversations for your communities (replies reach users via Reddit Chat). Requires scopes: modmail. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/modmail.

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

## Reddit: Mark unread (Modmail)

`POST /accounts/{accountId}/reddit/modmail/{itemId}/unread`

Mark unread. New modmail conversations for your communities (replies reach users via Reddit Chat). Requires scopes: modmail. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/modmail.

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

## Reddit: Mute user (Modmail)

`POST /accounts/{accountId}/reddit/modmail/{itemId}/mute`

Mute user. New modmail conversations for your communities (replies reach users via Reddit Chat). Requires scopes: modmail. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/modmail.

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

### Body

- `num_hours` (integer; one of 72, 168, 672)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/modmail/ITEM_ID/mute" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "num_hours": 72
  }'
```

Response 200:

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

## Reddit: Unmute user (Modmail)

`POST /accounts/{accountId}/reddit/modmail/{itemId}/unmute`

Unmute user. New modmail conversations for your communities (replies reach users via Reddit Chat). Requires scopes: modmail. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/modmail.

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

## Reddit: Temporarily ban user (Modmail)

`POST /accounts/{accountId}/reddit/modmail/{itemId}/temp-ban`

Temporarily ban user. New modmail conversations for your communities (replies reach users via Reddit Chat). Destructive. Requires scopes: modmail. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/modmail.

Access: `write` · MCP tool: `reddit-modmail-temp-ban`

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

- `duration` (integer; 1–999): Days

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/modmail/ITEM_ID/temp-ban" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "duration": 7
  }'
```

Response 200:

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

## Reddit: Unban user (Modmail)

`POST /accounts/{accountId}/reddit/modmail/{itemId}/unban`

Unban user. New modmail conversations for your communities (replies reach users via Reddit Chat). Requires scopes: modmail. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/modmail.

Access: `write` · MCP tool: `reddit-modmail-unban`

### 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/reddit/modmail/ITEM_ID/unban" \
  -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
}
```

## Reddit: Approve user (Modmail)

`POST /accounts/{accountId}/reddit/modmail/{itemId}/approve`

Approve user. New modmail conversations for your communities (replies reach users via Reddit Chat). Requires scopes: modmail. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/modmail.

Access: `write` · MCP tool: `reddit-modmail-approve`

### 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/reddit/modmail/ITEM_ID/approve" \
  -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
}
```

## Reddit: Remove approved user (Modmail)

`POST /accounts/{accountId}/reddit/modmail/{itemId}/disapprove`

Remove approved user. New modmail conversations for your communities (replies reach users via Reddit Chat). Requires scopes: modmail. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/modmail.

Access: `write` · MCP tool: `reddit-modmail-disapprove`

### 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/reddit/modmail/ITEM_ID/disapprove" \
  -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
}
```

## Reddit: Unread counts (Modmail)

`POST /accounts/{accountId}/reddit/modmail/unread-count`

Unread counts. New modmail conversations for your communities (replies reach users via Reddit Chat). Requires scopes: modmail. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/modmail.

Access: `write` · MCP tool: `reddit-modmail-unread-count`

### Path parameters

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

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

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

Response 200:

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

## Reddit: List Banned users

`GET /accounts/{accountId}/reddit/banned-users`

GET /r/{sr}/about/banned. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/banned-users.

Access: `read` · MCP tool: `reddit-banned-users-list`

### Path parameters

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

### Query parameters

- `cursor` (string): Pagination cursor (Reddit after fullname)
- `limit` (integer; 1–100)
- `subreddit` (string; ≥ 1 characters): Subreddit name without r/
- `user` (string): Find one user

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "subreddit": "string",
      "username": "string",
      "user_id": "string",
      "since": "2026-10-13T09:00:00.000Z",
      "note": "string",
      "days_left": 1,
      "permissions": [
        "string"
      ],
      "flair_text": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Reddit: Create a Banned users item

`POST /accounts/{accountId}/reddit/banned-users`

POST /r/{sr}/api/friend type=banned. Requires scopes: read, modcontributors. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/banned-users.

Access: `write` · MCP tool: `reddit-banned-users-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

- `subreddit` (string; required; ≥ 1 characters): Subreddit name without r/
- `username` (string; required; ≥ 1 characters)
- `duration` (integer; 1–999): Days; omit for permanent
- `ban_reason` (string; ≤ 100 characters): Reason (rule)
- `note` (string; ≤ 300 characters): Private mod note
- `ban_message` (string): Message sent to the user
- `ban_context` (string): Fullname of the offending post/comment

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/banned-users" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "subreddit": "string",
    "username": "string",
    "duration": 1,
    "ban_reason": "string",
    "note": "string"
  }'
```

Response 201:

```json
{
  "id": "string",
  "subreddit": "string",
  "username": "string",
  "user_id": "string",
  "since": "2026-10-13T09:00:00.000Z",
  "note": "string",
  "days_left": 1,
  "permissions": [
    "string"
  ],
  "flair_text": "string"
}
```

## Reddit: Delete a Banned users item

`DELETE /accounts/{accountId}/reddit/banned-users/{itemId}`

POST /r/{sr}/api/unfriend type=banned. Requires scopes: read, modcontributors. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/banned-users.

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

Response 200:

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

## Reddit: List Muted users

`GET /accounts/{accountId}/reddit/muted-users`

GET /r/{sr}/about/muted. Users muted from modmail. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/muted-users.

Access: `read` · MCP tool: `reddit-muted-users-list`

### Path parameters

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

### Query parameters

- `cursor` (string): Pagination cursor (Reddit after fullname)
- `limit` (integer; 1–100)
- `subreddit` (string; ≥ 1 characters): Subreddit name without r/
- `user` (string): Find one user

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "subreddit": "string",
      "username": "string",
      "user_id": "string",
      "since": "2026-10-13T09:00:00.000Z",
      "note": "string",
      "days_left": 1,
      "permissions": [
        "string"
      ],
      "flair_text": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Reddit: Create a Muted users item

`POST /accounts/{accountId}/reddit/muted-users`

POST /r/{sr}/api/friend type=muted. Users muted from modmail. Requires scopes: read, modcontributors. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/muted-users.

Access: `write` · MCP tool: `reddit-muted-users-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

- `subreddit` (string; required; ≥ 1 characters): Subreddit name without r/
- `username` (string; required; ≥ 1 characters)
- `note` (string; ≤ 300 characters)

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

Response 201:

```json
{
  "id": "string",
  "subreddit": "string",
  "username": "string",
  "user_id": "string",
  "since": "2026-10-13T09:00:00.000Z",
  "note": "string",
  "days_left": 1,
  "permissions": [
    "string"
  ],
  "flair_text": "string"
}
```

## Reddit: Delete a Muted users item

`DELETE /accounts/{accountId}/reddit/muted-users/{itemId}`

POST /r/{sr}/api/unfriend type=muted. Users muted from modmail. Requires scopes: read, modcontributors. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/muted-users.

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

Response 200:

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

## Reddit: List Approved users

`GET /accounts/{accountId}/reddit/approved-users`

GET /r/{sr}/about/contributors. Approved contributors (can post in restricted/private communities). Cursor pagination: pass next_cursor back as cursor. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/approved-users.

Access: `read` · MCP tool: `reddit-approved-users-list`

### Path parameters

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

### Query parameters

- `cursor` (string): Pagination cursor (Reddit after fullname)
- `limit` (integer; 1–100)
- `subreddit` (string; ≥ 1 characters): Subreddit name without r/
- `user` (string): Find one user

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "subreddit": "string",
      "username": "string",
      "user_id": "string",
      "since": "2026-10-13T09:00:00.000Z",
      "note": "string",
      "days_left": 1,
      "permissions": [
        "string"
      ],
      "flair_text": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Reddit: Create a Approved users item

`POST /accounts/{accountId}/reddit/approved-users`

POST /r/{sr}/api/friend type=contributor. Approved contributors (can post in restricted/private communities). Requires scopes: read, modcontributors. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/approved-users.

Access: `write` · MCP tool: `reddit-approved-users-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

- `subreddit` (string; required; ≥ 1 characters): Subreddit name without r/
- `username` (string; required; ≥ 1 characters)

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

Response 201:

```json
{
  "id": "string",
  "subreddit": "string",
  "username": "string",
  "user_id": "string",
  "since": "2026-10-13T09:00:00.000Z",
  "note": "string",
  "days_left": 1,
  "permissions": [
    "string"
  ],
  "flair_text": "string"
}
```

## Reddit: Delete a Approved users item

`DELETE /accounts/{accountId}/reddit/approved-users/{itemId}`

POST /r/{sr}/api/unfriend type=contributor. Approved contributors (can post in restricted/private communities). Requires scopes: read, modcontributors. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/approved-users.

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

Response 200:

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

## Reddit: List Wiki-banned users

`GET /accounts/{accountId}/reddit/wiki-banned`

GET /r/{sr}/about/wikibanned. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/wiki-banned.

Access: `read` · MCP tool: `reddit-wiki-banned-list`

### Path parameters

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

### Query parameters

- `cursor` (string): Pagination cursor (Reddit after fullname)
- `limit` (integer; 1–100)
- `subreddit` (string; ≥ 1 characters): Subreddit name without r/
- `user` (string): Find one user

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "subreddit": "string",
      "username": "string",
      "user_id": "string",
      "since": "2026-10-13T09:00:00.000Z",
      "note": "string",
      "days_left": 1,
      "permissions": [
        "string"
      ],
      "flair_text": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Reddit: Create a Wiki-banned users item

`POST /accounts/{accountId}/reddit/wiki-banned`

POST /r/{sr}/api/friend type=wikibanned. Requires scopes: read, modcontributors, modwiki. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/wiki-banned.

Access: `write` · MCP tool: `reddit-wiki-banned-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

- `subreddit` (string; required; ≥ 1 characters): Subreddit name without r/
- `username` (string; required; ≥ 1 characters)
- `duration` (integer; 1–999)
- `note` (string; ≤ 300 characters)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/wiki-banned" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "subreddit": "string",
    "username": "string",
    "duration": 1,
    "note": "string"
  }'
```

Response 201:

```json
{
  "id": "string",
  "subreddit": "string",
  "username": "string",
  "user_id": "string",
  "since": "2026-10-13T09:00:00.000Z",
  "note": "string",
  "days_left": 1,
  "permissions": [
    "string"
  ],
  "flair_text": "string"
}
```

## Reddit: Delete a Wiki-banned users item

`DELETE /accounts/{accountId}/reddit/wiki-banned/{itemId}`

POST /r/{sr}/api/unfriend type=wikibanned. Requires scopes: read, modcontributors, modwiki. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/wiki-banned.

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

Response 200:

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

## Reddit: List Wiki contributors

`GET /accounts/{accountId}/reddit/wiki-contributors`

GET /r/{sr}/about/wikicontributors. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/wiki-contributors.

Access: `read` · MCP tool: `reddit-wiki-contributors-list`

### Path parameters

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

### Query parameters

- `cursor` (string): Pagination cursor (Reddit after fullname)
- `limit` (integer; 1–100)
- `subreddit` (string; ≥ 1 characters): Subreddit name without r/
- `user` (string): Find one user

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "subreddit": "string",
      "username": "string",
      "user_id": "string",
      "since": "2026-10-13T09:00:00.000Z",
      "note": "string",
      "days_left": 1,
      "permissions": [
        "string"
      ],
      "flair_text": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Reddit: Create a Wiki contributors item

`POST /accounts/{accountId}/reddit/wiki-contributors`

POST /r/{sr}/api/friend type=wikicontributor. Requires scopes: read, modcontributors, modwiki. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/wiki-contributors.

Access: `write` · MCP tool: `reddit-wiki-contributors-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

- `subreddit` (string; required; ≥ 1 characters): Subreddit name without r/
- `username` (string; required; ≥ 1 characters)

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

Response 201:

```json
{
  "id": "string",
  "subreddit": "string",
  "username": "string",
  "user_id": "string",
  "since": "2026-10-13T09:00:00.000Z",
  "note": "string",
  "days_left": 1,
  "permissions": [
    "string"
  ],
  "flair_text": "string"
}
```

## Reddit: Delete a Wiki contributors item

`DELETE /accounts/{accountId}/reddit/wiki-contributors/{itemId}`

POST /r/{sr}/api/unfriend type=wikicontributor. Requires scopes: read, modcontributors, modwiki. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/wiki-contributors.

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

Response 200:

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

## Reddit: List Moderators

`GET /accounts/{accountId}/reddit/moderators`

GET /r/{sr}/about/moderators. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/moderators.

Access: `read` · MCP tool: `reddit-moderators-list`

### Path parameters

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

### Query parameters

- `subreddit` (string; ≥ 1 characters): Subreddit name without r/

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "subreddit": "string",
      "username": "string",
      "user_id": "string",
      "since": "2026-10-13T09:00:00.000Z",
      "note": "string",
      "days_left": 1,
      "permissions": [
        "string"
      ],
      "flair_text": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Reddit: Create a Moderators item

`POST /accounts/{accountId}/reddit/moderators`

POST /r/{sr}/api/friend type=moderator_invite. Requires scopes: read, modothers. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/moderators.

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

- `subreddit` (string; required; ≥ 1 characters): Subreddit name without r/
- `username` (string; required; ≥ 1 characters)
- `permissions` (array of string)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/moderators" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "subreddit": "string",
    "username": "string",
    "permissions": [
      "all"
    ]
  }'
```

Response 201:

```json
{
  "id": "string",
  "subreddit": "string",
  "username": "string",
  "user_id": "string",
  "since": "2026-10-13T09:00:00.000Z",
  "note": "string",
  "days_left": 1,
  "permissions": [
    "string"
  ],
  "flair_text": "string"
}
```

## Reddit: Update a Moderators item

`PATCH /accounts/{accountId}/reddit/moderators/{itemId}`

POST /r/{sr}/api/setpermissions. Requires scopes: read, modothers. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/moderators.

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

- `permissions` (array of string; required)
- `invite` (boolean): Change a pending invite instead

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/moderators/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "permissions": [
      "all"
    ],
    "invite": false
  }'
```

Response 200:

```json
{
  "id": "string",
  "subreddit": "string",
  "username": "string",
  "user_id": "string",
  "since": "2026-10-13T09:00:00.000Z",
  "note": "string",
  "days_left": 1,
  "permissions": [
    "string"
  ],
  "flair_text": "string"
}
```

## Reddit: Delete a Moderators item

`DELETE /accounts/{accountId}/reddit/moderators/{itemId}`

POST /r/{sr}/api/unfriend type=moderator. Requires scopes: read, modothers. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/moderators.

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

## Reddit: Pending invites (Moderators)

`POST /accounts/{accountId}/reddit/moderators/invited`

Pending invites. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/moderators.

Access: `write` · MCP tool: `reddit-moderators-invited`

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

- `subreddit` (string; required; ≥ 1 characters): Subreddit name without r/

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

Response 200:

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

## Reddit: Cancel invite (Moderators)

`POST /accounts/{accountId}/reddit/moderators/{itemId}/cancel-invite`

Cancel invite. Requires scopes: read, modothers. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/moderators.

Access: `write` · MCP tool: `reddit-moderators-cancel-invite`

### 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/reddit/moderators/ITEM_ID/cancel-invite" \
  -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
}
```

## Reddit: List Mod notes

`GET /accounts/{accountId}/reddit/mod-notes`

GET /api/mod/notes. Private moderator notes about users (note ≤250 chars). Cursor pagination: pass next_cursor back as cursor. Requires scopes: modnote. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mod-notes.

Access: `read` · MCP tool: `reddit-mod-notes-list`

### Path parameters

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

### Query parameters

- `subreddit` (string; ≥ 1 characters): Subreddit name without r/
- `user` (string; ≥ 1 characters)
- `filter` (string; one of NOTE, APPROVAL, REMOVAL, BAN, MUTE, INVITE, SPAM, CONTENT_CHANGE, MOD_ACTION, ALL)
- `cursor` (string)
- `limit` (integer; 1–100)

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "note_id": "string",
      "type": "string",
      "subreddit": "string",
      "user": "string",
      "operator": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "note": "string",
      "label": "BOT_BAN",
      "reddit_id": "string",
      "action": "string",
      "details": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Reddit: Create a Mod notes item

`POST /accounts/{accountId}/reddit/mod-notes`

POST /api/mod/notes. Private moderator notes about users (note ≤250 chars). Requires scopes: modnote. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mod-notes.

Access: `write` · MCP tool: `reddit-mod-notes-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

- `subreddit` (string; required; ≥ 1 characters): Subreddit name without r/
- `user` (string; required)
- `note` (string; required; 1–250 characters)
- `label` (string; one of BOT_BAN, PERMA_BAN, BAN, ABUSE_WARNING, SPAM_WARNING, SPAM_WATCH, SOLID_CONTRIBUTOR, HELPFUL_USER)
- `reddit_id` (string): Related t3_/t1_ fullname

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/mod-notes" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "subreddit": "string",
    "user": "string",
    "note": "string",
    "label": "BOT_BAN",
    "reddit_id": "string"
  }'
```

Response 201:

```json
{
  "id": "string",
  "note_id": "string",
  "type": "string",
  "subreddit": "string",
  "user": "string",
  "operator": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "note": "string",
  "label": "BOT_BAN",
  "reddit_id": "string",
  "action": "string",
  "details": "string"
}
```

## Reddit: Delete a Mod notes item

`DELETE /accounts/{accountId}/reddit/mod-notes/{itemId}`

DELETE /api/mod/notes. Private moderator notes about users (note ≤250 chars). Requires scopes: modnote. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mod-notes.

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

Response 200:

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

## Reddit: Latest note per user (Mod notes)

`POST /accounts/{accountId}/reddit/mod-notes/recent`

Latest note per user. Private moderator notes about users (note ≤250 chars). Requires scopes: modnote. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/mod-notes.

Access: `write` · MCP tool: `reddit-mod-notes-recent`

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

- `subreddits` (array of string; required)
- `users` (array of string; required)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/mod-notes/recent" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "subreddits": [
      "string"
    ],
    "users": [
      "string"
    ]
  }'
```

Response 200:

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

## Reddit: List Removal reasons

`GET /accounts/{accountId}/reddit/removal-reasons`

GET /api/v1/{sr}/removal_reasons. Reusable removal reasons (undocumented endpoints; scope unverified). Cursor pagination: pass next_cursor back as cursor. Requires one of: modposts | modconfig. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/removal-reasons.

Access: `read` · MCP tool: `reddit-removal-reasons-list`

### Path parameters

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

### Query parameters

- `subreddit` (string; ≥ 1 characters): Subreddit name without r/

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

Response 200:

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

## Reddit: Create a Removal reasons item

`POST /accounts/{accountId}/reddit/removal-reasons`

POST /api/v1/{sr}/removal_reasons. Reusable removal reasons (undocumented endpoints; scope unverified). Requires one of: modposts | modconfig. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/removal-reasons.

Access: `write` · MCP tool: `reddit-removal-reasons-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

- `subreddit` (string; required; ≥ 1 characters): Subreddit name without r/
- `title` (string; required; 1–50 characters)
- `message` (string; required; ≥ 1 characters)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/removal-reasons" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "subreddit": "string",
    "title": "string",
    "message": "string"
  }'
```

Response 201:

```json
{
  "id": "string",
  "reason_id": "string",
  "subreddit": "string",
  "title": "string",
  "message": "string"
}
```

## Reddit: Update a Removal reasons item

`PATCH /accounts/{accountId}/reddit/removal-reasons/{itemId}`

PUT /api/v1/{sr}/removal_reasons/{id}. Reusable removal reasons (undocumented endpoints; scope unverified). Requires one of: modposts | modconfig. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/removal-reasons.

Access: `write` · MCP tool: `reddit-removal-reasons-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; ≤ 50 characters)
- `message` (string)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/removal-reasons/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "string",
    "message": "string"
  }'
```

Response 200:

```json
{
  "id": "string",
  "reason_id": "string",
  "subreddit": "string",
  "title": "string",
  "message": "string"
}
```

## Reddit: Delete a Removal reasons item

`DELETE /accounts/{accountId}/reddit/removal-reasons/{itemId}`

DELETE /api/v1/{sr}/removal_reasons/{id}. Reusable removal reasons (undocumented endpoints; scope unverified). Requires one of: modposts | modconfig. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/removal-reasons.

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

Response 200:

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

## Reddit: List Flair templates

`GET /accounts/{accountId}/reddit/flair-templates`

GET /r/{sr}/api/link_flair_v2 | user_flair_v2. Create, edit, reorder and delete link (post) and user flair templates. Cursor pagination: pass next_cursor back as cursor. Requires scopes: flair. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/flair-templates.

Access: `read` · MCP tool: `reddit-flair-templates-list`

### Path parameters

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

### Query parameters

- `subreddit` (string; ≥ 1 characters): Subreddit name without r/
- `flair_type` (string; one of LINK_FLAIR, USER_FLAIR)

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "template_id": "string",
      "subreddit": "string",
      "flair_type": "LINK_FLAIR",
      "text": "string",
      "textColor": "light",
      "backgroundColor": "string",
      "textEditable": true,
      "modOnly": true,
      "allowableContent": "all",
      "maxEmojis": 1,
      "cssClass": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Reddit: Create a Flair templates item

`POST /accounts/{accountId}/reddit/flair-templates`

POST /r/{sr}/api/flairtemplate_v2. Create, edit, reorder and delete link (post) and user flair templates. Requires scopes: flair, modflair. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/flair-templates.

Access: `write` · MCP tool: `reddit-flair-templates-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

- `subreddit` (string; required; ≥ 1 characters): Subreddit name without r/
- `flair_type` (string; one of LINK_FLAIR, USER_FLAIR)
- `text` (string; required; ≤ 64 characters)
- `text_color` (string; one of light, dark)
- `background_color` (string; pattern ^#?[0-9a-fA-F]{6}$|^transparent$)
- `css_class` (string)
- `text_editable` (boolean)
- `mod_only` (boolean)
- `allowable_content` (string; one of all, emoji, text)
- `max_emojis` (integer; 1–10)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/flair-templates" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "subreddit": "string",
    "flair_type": "LINK_FLAIR",
    "text": "string",
    "text_color": "light",
    "background_color": "string"
  }'
```

Response 201:

```json
{
  "id": "string",
  "template_id": "string",
  "subreddit": "string",
  "flair_type": "LINK_FLAIR",
  "text": "string",
  "textColor": "light",
  "backgroundColor": "string",
  "textEditable": true,
  "modOnly": true,
  "allowableContent": "all",
  "maxEmojis": 1,
  "cssClass": "string"
}
```

## Reddit: Update a Flair templates item

`PATCH /accounts/{accountId}/reddit/flair-templates/{itemId}`

POST /r/{sr}/api/flairtemplate_v2 (flair_template_id). Create, edit, reorder and delete link (post) and user flair templates. Requires scopes: flair, modflair. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/flair-templates.

Access: `write` · MCP tool: `reddit-flair-templates-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

- `flair_type` (string; one of LINK_FLAIR, USER_FLAIR)
- `text` (string; ≤ 64 characters)
- `text_color` (string; one of light, dark)
- `background_color` (string; pattern ^#?[0-9a-fA-F]{6}$|^transparent$)
- `css_class` (string)
- `text_editable` (boolean)
- `mod_only` (boolean)
- `allowable_content` (string; one of all, emoji, text)
- `max_emojis` (integer; 1–10)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/flair-templates/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "flair_type": "LINK_FLAIR",
    "text": "string",
    "text_color": "light",
    "background_color": "string",
    "css_class": "string"
  }'
```

Response 200:

```json
{
  "id": "string",
  "template_id": "string",
  "subreddit": "string",
  "flair_type": "LINK_FLAIR",
  "text": "string",
  "textColor": "light",
  "backgroundColor": "string",
  "textEditable": true,
  "modOnly": true,
  "allowableContent": "all",
  "maxEmojis": 1,
  "cssClass": "string"
}
```

## Reddit: Delete a Flair templates item

`DELETE /accounts/{accountId}/reddit/flair-templates/{itemId}`

POST /r/{sr}/api/deleteflairtemplate. Create, edit, reorder and delete link (post) and user flair templates. Requires scopes: flair, modflair. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/flair-templates.

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

Response 200:

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

## Reddit: Reorder templates (Flair templates)

`POST /accounts/{accountId}/reddit/flair-templates/reorder`

Reorder templates. Create, edit, reorder and delete link (post) and user flair templates. Requires scopes: flair, modflair. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/flair-templates.

Access: `write` · MCP tool: `reddit-flair-templates-reorder`

### Path parameters

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

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `subreddit` (string; required; ≥ 1 characters): Subreddit name without r/
- `flair_type` (string; required; one of LINK_FLAIR, USER_FLAIR)
- `order` (array of string; required): template ids

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/flair-templates/reorder" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "subreddit": "string",
    "flair_type": "LINK_FLAIR",
    "order": [
      "string"
    ]
  }'
```

Response 200:

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

## Reddit: Delete all templates (Flair templates)

`POST /accounts/{accountId}/reddit/flair-templates/clear-all`

Delete all templates. Create, edit, reorder and delete link (post) and user flair templates. Destructive. Requires scopes: flair, modflair. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/flair-templates.

Access: `write` · MCP tool: `reddit-flair-templates-clear-all`

### Path parameters

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

### Body

- `subreddit` (string; required; ≥ 1 characters): Subreddit name without r/
- `flair_type` (string; required; one of LINK_FLAIR, USER_FLAIR)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/flair-templates/clear-all" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "subreddit": "string",
    "flair_type": "LINK_FLAIR"
  }'
```

Response 200:

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

## Reddit: Flair settings (Flair templates)

`POST /accounts/{accountId}/reddit/flair-templates/configure`

Flair settings. Create, edit, reorder and delete link (post) and user flair templates. Requires scopes: flair, modflair. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/flair-templates.

Access: `write` · MCP tool: `reddit-flair-templates-configure`

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

- `subreddit` (string; required; ≥ 1 characters): Subreddit name without r/
- `flair_enabled` (boolean)
- `flair_position` (string; one of left, right)
- `flair_self_assign_enabled` (boolean)
- `link_flair_position` (string; one of , left, right)
- `link_flair_self_assign_enabled` (boolean)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/flair-templates/configure" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "subreddit": "string",
    "flair_enabled": true,
    "flair_position": "left",
    "flair_self_assign_enabled": true,
    "link_flair_position": ""
  }'
```

Response 200:

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

## Reddit: List User flair assignments

`GET /accounts/{accountId}/reddit/user-flairs`

GET /r/{sr}/api/flairlist. Cursor pagination: pass next_cursor back as cursor. Requires scopes: modflair. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/user-flairs.

Access: `read` · MCP tool: `reddit-user-flairs-list`

### Path parameters

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

### Query parameters

- `cursor` (string): Pagination cursor (Reddit after fullname)
- `limit` (integer; 1–100)
- `subreddit` (string; ≥ 1 characters): Subreddit name without r/
- `user` (string)

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

Response 200:

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

## Reddit: Create a User flair assignments item

`POST /accounts/{accountId}/reddit/user-flairs`

POST /r/{sr}/api/flair | selectflair. Requires scopes: modflair. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/user-flairs.

Access: `write` · MCP tool: `reddit-user-flairs-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

- `subreddit` (string; required; ≥ 1 characters): Subreddit name without r/
- `username` (string; required; ≥ 1 characters)
- `text` (string; ≤ 64 characters)
- `css_class` (string)
- `flair_template_id` (string)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/user-flairs" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "subreddit": "string",
    "username": "string",
    "text": "string",
    "css_class": "string",
    "flair_template_id": "string"
  }'
```

Response 201:

```json
{
  "id": "string",
  "subreddit": "string",
  "username": "string",
  "flair_text": "string",
  "flair_css_class": "string"
}
```

## Reddit: Update a User flair assignments item

`PATCH /accounts/{accountId}/reddit/user-flairs/{itemId}`

POST /r/{sr}/api/flair | selectflair. Requires scopes: modflair. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/user-flairs.

Access: `write` · MCP tool: `reddit-user-flairs-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; ≤ 64 characters)
- `css_class` (string)
- `flair_template_id` (string)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/user-flairs/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string",
    "css_class": "string",
    "flair_template_id": "string"
  }'
```

Response 200:

```json
{
  "id": "string",
  "subreddit": "string",
  "username": "string",
  "flair_text": "string",
  "flair_css_class": "string"
}
```

## Reddit: Delete a User flair assignments item

`DELETE /accounts/{accountId}/reddit/user-flairs/{itemId}`

POST /r/{sr}/api/deleteflair. Requires scopes: modflair. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/user-flairs.

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

Response 200:

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

## Reddit: Bulk set (CSV) (User flair assignments)

`POST /accounts/{accountId}/reddit/user-flairs/bulk-set`

Up to 100 lines of "user,text,css_class" per call. Requires scopes: modflair. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/user-flairs.

Access: `write` · MCP tool: `reddit-user-flairs-bulk-set`

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

- `subreddit` (string; required; ≥ 1 characters): Subreddit name without r/
- `csv` (string; required)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/user-flairs/bulk-set" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "subreddit": "string",
    "csv": "string"
  }'
```

Response 200:

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

## Reddit: Get Community settings

`GET /accounts/{accountId}/reddit/subreddit-settings`

GET /r/{sr}/about/edit. Subreddit settings. Updates are merged onto the current settings (site_admin needs the full set). Requires scopes: modconfig. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/subreddit-settings.

Access: `read` · MCP tool: `reddit-subreddit-settings-get`

### Path parameters

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

### Query parameters

- `subreddit` (string; ≥ 1 characters): Subreddit name without r/

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

Response 200:

```json
{
  "subreddit": "string",
  "title": "string",
  "public_description": "string",
  "description": "string",
  "submit_text": "string",
  "submit_link_label": "string",
  "submit_text_label": "string",
  "subreddit_type": "public",
  "content_options": "any",
  "over_18": true,
  "allow_images": true,
  "allow_videos": true,
  "allow_polls": true,
  "allow_galleries": true,
  "allow_post_crossposts": true,
  "spoilers_enabled": true,
  "original_content_tag_enabled": true,
  "allow_discovery": true,
  "default_set": true,
  "language": "en",
  "welcome_message_enabled": true,
  "welcome_message_text": "string",
  "wikimode": "disabled",
  "wiki_edit_age": 0,
  "wiki_edit_karma": 0,
  "spam_links": "low",
  "spam_selfposts": "low",
  "spam_comments": "low",
  "exclude_banned_modqueue": true,
  "collapse_deleted_comments": true,
  "comment_score_hide_mins": 0,
  "suggested_comment_sort": "confidence",
  "show_media": true,
  "show_media_preview": true,
  "crowd_control_mode": true,
  "free_form_reports": true,
  "key_color": "string",
  "header_hover_text": "string"
}
```

## Reddit: Update Community settings

`PATCH /accounts/{accountId}/reddit/subreddit-settings`

GET /r/{sr}/about/edit → merge → POST /api/site_admin. Subreddit settings. Updates are merged onto the current settings (site_admin needs the full set). Requires scopes: modconfig. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/subreddit-settings.

Access: `write` · MCP tool: `reddit-subreddit-settings-update`

### Path parameters

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

### Body

- `subreddit` (string; required; ≥ 1 characters): Subreddit name without r/
- `title` (string; ≤ 100 characters)
- `public_description` (string; ≤ 500 characters)
- `description` (string): Old-reddit sidebar (markdown)
- `submit_text` (string)
- `submit_link_label` (string; ≤ 60 characters)
- `submit_text_label` (string; ≤ 60 characters)
- `subreddit_type` (string; one of public, private, restricted, gold_restricted, archived, employees_only, gold_only)
- `content_options` (string; one of any, link, self)
- `over_18` (boolean)
- `allow_images` (boolean)
- `allow_videos` (boolean)
- `allow_polls` (boolean)
- `allow_galleries` (boolean)
- `allow_post_crossposts` (boolean)
- `spoilers_enabled` (boolean)
- `original_content_tag_enabled` (boolean)
- `allow_discovery` (boolean)
- `default_set` (boolean): Allow in r/all & popular
- `language` (string)
- `welcome_message_enabled` (boolean)
- `welcome_message_text` (string)
- `wikimode` (string; one of disabled, modonly, anyone)
- `wiki_edit_age` (integer)
- `wiki_edit_karma` (integer)
- `spam_links` (string; one of low, high, all)
- `spam_selfposts` (string; one of low, high, all)
- `spam_comments` (string; one of low, high, all)
- `exclude_banned_modqueue` (boolean)
- `collapse_deleted_comments` (boolean)
- `comment_score_hide_mins` (integer; 0–1440)
- `suggested_comment_sort` (string | null; one of confidence, top, new, controversial, old, random, qa, live)
- `show_media` (boolean)
- `show_media_preview` (boolean)
- `crowd_control_mode` (boolean)
- `free_form_reports` (boolean)
- `key_color` (string)
- `header_hover_text` (string; ≤ 500 characters)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/subreddit-settings" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "subreddit": "string",
    "title": "string",
    "public_description": "string",
    "description": "string",
    "submit_text": "string"
  }'
```

Response 200:

```json
{
  "subreddit": "string",
  "title": "string",
  "public_description": "string",
  "description": "string",
  "submit_text": "string",
  "submit_link_label": "string",
  "submit_text_label": "string",
  "subreddit_type": "public",
  "content_options": "any",
  "over_18": true,
  "allow_images": true,
  "allow_videos": true,
  "allow_polls": true,
  "allow_galleries": true,
  "allow_post_crossposts": true,
  "spoilers_enabled": true,
  "original_content_tag_enabled": true,
  "allow_discovery": true,
  "default_set": true,
  "language": "en",
  "welcome_message_enabled": true,
  "welcome_message_text": "string",
  "wikimode": "disabled",
  "wiki_edit_age": 0,
  "wiki_edit_karma": 0,
  "spam_links": "low",
  "spam_selfposts": "low",
  "spam_comments": "low",
  "exclude_banned_modqueue": true,
  "collapse_deleted_comments": true,
  "comment_score_hide_mins": 0,
  "suggested_comment_sort": "confidence",
  "show_media": true,
  "show_media_preview": true,
  "crowd_control_mode": true,
  "free_form_reports": true,
  "key_color": "string",
  "header_hover_text": "string"
}
```

## Reddit: Get Old-reddit stylesheet

`GET /accounts/{accountId}/reddit/stylesheet`

GET /r/{sr}/about/stylesheet. Requires scopes: modconfig. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/stylesheet.

Access: `read` · MCP tool: `reddit-stylesheet-get`

### Path parameters

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

### Query parameters

- `subreddit` (string; ≥ 1 characters): Subreddit name without r/

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

Response 200:

```json
{
  "subreddit": "string",
  "stylesheet": "string",
  "images": [
    {
      "name": "string",
      "url": "https://example.com",
      "link": "https://example.com"
    }
  ]
}
```

## Reddit: Update Old-reddit stylesheet

`PATCH /accounts/{accountId}/reddit/stylesheet`

POST /r/{sr}/api/subreddit_stylesheet. Requires scopes: modconfig. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/stylesheet.

Access: `write` · MCP tool: `reddit-stylesheet-update`

### Path parameters

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

### Body

- `subreddit` (string; required; ≥ 1 characters): Subreddit name without r/
- `stylesheet` (string; required)
- `reason` (string; ≤ 256 characters)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/stylesheet" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "subreddit": "string",
    "stylesheet": "string",
    "reason": "string"
  }'
```

Response 200:

```json
{
  "subreddit": "string",
  "stylesheet": "string",
  "images": [
    {
      "name": "string",
      "url": "https://example.com",
      "link": "https://example.com"
    }
  ]
}
```

## Reddit: List Sidebar widgets

`GET /accounts/{accountId}/reddit/widgets`

GET /r/{sr}/api/widgets. New-reddit widgets (text, button, community list, calendar, rules, images…). Bodies follow Reddit widget JSON. Cursor pagination: pass next_cursor back as cursor. Requires scopes: structuredstyles. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/widgets.

Access: `read` · MCP tool: `reddit-widgets-list`

### Path parameters

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

### Query parameters

- `subreddit` (string; ≥ 1 characters): Subreddit name without r/

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "widget_id": "string",
      "subreddit": "string",
      "section": "sidebar",
      "kind": "string",
      "short_name": "string",
      "data": {}
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Reddit: Create a Sidebar widgets item

`POST /accounts/{accountId}/reddit/widgets`

POST /r/{sr}/api/widget. New-reddit widgets (text, button, community list, calendar, rules, images…). Bodies follow Reddit widget JSON. Requires scopes: structuredstyles. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/widgets.

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

- `subreddit` (string; required; ≥ 1 characters): Subreddit name without r/
- `widget` (object; required)
  - `widget.kind` (string; required)
  - `widget.shortName` (string)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/widgets" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "subreddit": "string",
    "widget": {
      "kind": "string",
      "shortName": "string"
    }
  }'
```

Response 201:

```json
{
  "id": "string",
  "widget_id": "string",
  "subreddit": "string",
  "section": "sidebar",
  "kind": "string",
  "short_name": "string",
  "data": {}
}
```

## Reddit: Update a Sidebar widgets item

`PATCH /accounts/{accountId}/reddit/widgets/{itemId}`

PUT /r/{sr}/api/widget/{id}. New-reddit widgets (text, button, community list, calendar, rules, images…). Bodies follow Reddit widget JSON. Requires scopes: structuredstyles. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/widgets.

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

- `widget` (object; required)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/widgets/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "widget": {}
  }'
```

Response 200:

```json
{
  "id": "string",
  "widget_id": "string",
  "subreddit": "string",
  "section": "sidebar",
  "kind": "string",
  "short_name": "string",
  "data": {}
}
```

## Reddit: Delete a Sidebar widgets item

`DELETE /accounts/{accountId}/reddit/widgets/{itemId}`

DELETE /r/{sr}/api/widget/{id}. New-reddit widgets (text, button, community list, calendar, rules, images…). Bodies follow Reddit widget JSON. Requires scopes: structuredstyles. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/widgets.

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

Response 200:

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

## Reddit: Reorder sidebar (Sidebar widgets)

`POST /accounts/{accountId}/reddit/widgets/reorder`

Reorder sidebar. New-reddit widgets (text, button, community list, calendar, rules, images…). Bodies follow Reddit widget JSON. Requires scopes: structuredstyles. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/widgets.

Access: `write` · MCP tool: `reddit-widgets-reorder`

### Path parameters

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

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `subreddit` (string; required; ≥ 1 characters): Subreddit name without r/
- `section` (string; one of sidebar)
- `order` (array of string; required)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/widgets/reorder" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "subreddit": "string",
    "section": "sidebar",
    "order": [
      "string"
    ]
  }'
```

Response 200:

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

## Reddit: List Emojis

`GET /accounts/{accountId}/reddit/emojis`

GET /api/v1/{sr}/emojis/all. Custom subreddit emojis for flair and comments. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/emojis.

Access: `read` · MCP tool: `reddit-emojis-list`

### Path parameters

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

### Query parameters

- `subreddit` (string; ≥ 1 characters): Subreddit name without r/

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

Response 200:

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

## Reddit: Create a Emojis item

`POST /accounts/{accountId}/reddit/emojis`

POST /api/v1/{sr}/emoji_asset_upload_s3.json → S3 → POST /api/v1/{sr}/emoji.json. Custom subreddit emojis for flair and comments. Requires scopes: read, structuredstyles. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/emojis.

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

- `subreddit` (string; required; ≥ 1 characters): Subreddit name without r/
- `name` (string; required; pattern ^[A-Za-z0-9_-]{1,24}$)
- `image` (string; required)
- `mod_flair_only` (boolean)
- `post_flair_allowed` (boolean)
- `user_flair_allowed` (boolean)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/emojis" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "subreddit": "string",
    "name": "string",
    "image": "string",
    "mod_flair_only": false,
    "post_flair_allowed": true
  }'
```

Response 201:

```json
{
  "id": "string",
  "subreddit": "string",
  "name": "string",
  "url": "https://example.com",
  "mod_flair_only": true,
  "post_flair_allowed": true,
  "user_flair_allowed": true,
  "created_by": "string"
}
```

## Reddit: Delete a Emojis item

`DELETE /accounts/{accountId}/reddit/emojis/{itemId}`

DELETE /api/v1/{sr}/emoji/{name}. Custom subreddit emojis for flair and comments. Requires scopes: read, structuredstyles. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/emojis.

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

Response 200:

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

## Reddit: List Community traffic

`GET /accounts/{accountId}/reddit/traffic`

GET /r/{sr}/about/traffic. Uniques, pageviews and new subscribers of a subreddit you moderate. Cursor pagination: pass next_cursor back as cursor. Requires one of: modconfig | modtraffic. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/traffic.

Access: `read` · MCP tool: `reddit-traffic-list`

### Path parameters

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

### Query parameters

- `subreddit` (string; ≥ 1 characters): Subreddit name without r/
- `period` (string; one of day, hour, month)
- `since` (string (date)): YYYY-MM-DD
- `until` (string (date)): YYYY-MM-DD

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "date": "2026-10-13",
      "uniques": 1,
      "pageviews": 1,
      "subscriptions": 1
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Reddit: List Karma by subreddit

`GET /accounts/{accountId}/reddit/karma`

GET /api/v1/me/karma. Cursor pagination: pass next_cursor back as cursor. Requires scopes: mysubreddits. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/karma.

Access: `read` · MCP tool: `reddit-karma-list`

### Path parameters

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

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

Response 200:

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

## Reddit: List Post performance

`GET /accounts/{accountId}/reddit/post-performance`

GET /user/{me}/submitted (aggregated). Daily upvotes, comments and crossposts of posts you created in the period (by post creation day). Cursor pagination: pass next_cursor back as cursor. Requires scopes: history. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/post-performance.

Access: `read` · MCP tool: `reddit-post-performance-list`

### Path parameters

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

### Query parameters

- `since` (string (date)): YYYY-MM-DD
- `until` (string (date)): YYYY-MM-DD

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "date": "2026-10-13",
      "likes": 1,
      "comments": 1,
      "shares": 1,
      "engagements": 1,
      "posts": 1,
      "followers": 1
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Reddit: List Performance by subreddit

`GET /accounts/{accountId}/reddit/subreddit-performance`

GET /user/{me}/submitted (aggregated per subreddit). Cursor pagination: pass next_cursor back as cursor. Requires scopes: history. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/subreddit-performance.

Access: `read` · MCP tool: `reddit-subreddit-performance-list`

### Path parameters

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

### Query parameters

- `since` (string (date)): YYYY-MM-DD
- `until` (string (date)): YYYY-MM-DD

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "subreddit": "string",
      "posts": 1,
      "total_score": 1,
      "avg_score": 1.5,
      "avg_upvote_ratio": 1.5,
      "total_comments": 1,
      "avg_comments": 1.5,
      "removed": 1
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Reddit: List Best times to post

`GET /accounts/{accountId}/reddit/best-times`

GET /user/{me}/submitted (aggregated by weekday × hour). Average score and comments of your posts by UTC weekday (0 = Sunday) and hour. Cursor pagination: pass next_cursor back as cursor. Requires scopes: history. Network docs: https://www.reddit.com/dev/api/ Generic route: /v1/accounts/{accountId}/focus/best-times.

Access: `read` · MCP tool: `reddit-best-times-list`

### Path parameters

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

### Query parameters

- `since` (string (date)): YYYY-MM-DD
- `until` (string (date)): YYYY-MM-DD

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "key": "string",
      "weekday": 0,
      "hour": 0,
      "posts": 1,
      "avg_score": 1.5,
      "avg_comments": 1.5
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```


---

Source: https://socialit.com/docs/api-reference/focus-reddit/
