Skip to content
Docs

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

Base URLhttps://api.socialit.com/v1AuthenticationErrorsRate limits292 endpointsMCP toolset focus_reddit

Profile

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

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

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

idstring

t2_ fullname

usernamestring
created_atstring (date-time)
link_karmainteger
comment_karmainteger
total_karmainteger
awarder_karmainteger | null
awardee_karmainteger | null
icon_urlstring (uri) | null
snoovatar_urlstring (uri) | null
followersinteger | null

Profile followers

profile_titlestring | null
profile_descriptionstring | null
over_18boolean | null
is_modboolean | null
has_verified_emailboolean | null
is_suspendedboolean | null
accept_followersboolean | null
inbox_countinteger | null
has_mailboolean | null
has_mod_mailboolean | null

Responses

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

Preferences

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

Try it with MCPAsk your agent to call reddit-preferences-get (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

langstring

Interface language (e.g. en)

over_18boolean

I am over 18 and willing to view adult content

search_include_over_18boolean
label_nsfwboolean
hide_from_robotsboolean

Hide profile from search engines

show_presenceboolean

Show online status

enable_followersboolean

Allow people to follow you

accept_pmsstring

everyonewhitelisted

show_location_based_recommendationsboolean
activity_relevant_adsboolean
third_party_data_personalized_adsboolean
third_party_site_data_personalized_adsboolean
third_party_site_data_personalized_contentboolean
allow_clicktrackingboolean
mediastring

onoffsubreddit

media_previewstring

onoffsubreddit

nightmodeboolean
default_comment_sortstring

confidencetopnewcontroversialoldrandomqalive

ignore_suggested_sortboolean
send_welcome_messagesboolean
email_messagesboolean
email_unsubscribe_allboolean
feed_recommendations_enabledboolean
top_karma_subredditsboolean

Responses

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

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

Try it with MCPAsk your agent to call reddit-preferences-update (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

langstring

Interface language (e.g. en)

over_18boolean

I am over 18 and willing to view adult content

search_include_over_18boolean
label_nsfwboolean
hide_from_robotsboolean

Hide profile from search engines

show_presenceboolean

Show online status

enable_followersboolean

Allow people to follow you

accept_pmsstring

everyonewhitelisted

show_location_based_recommendationsboolean
activity_relevant_adsboolean
third_party_data_personalized_adsboolean
third_party_site_data_personalized_adsboolean
third_party_site_data_personalized_contentboolean
allow_clicktrackingboolean
mediastring

onoffsubreddit

media_previewstring

onoffsubreddit

nightmodeboolean
default_comment_sortstring

confidencetopnewcontroversialoldrandomqalive

ignore_suggested_sortboolean
send_welcome_messagesboolean
email_messagesboolean
email_unsubscribe_allboolean
feed_recommendations_enabledboolean
top_karma_subredditsboolean

Returns object

langstring

Interface language (e.g. en)

over_18boolean

I am over 18 and willing to view adult content

search_include_over_18boolean
label_nsfwboolean
hide_from_robotsboolean

Hide profile from search engines

show_presenceboolean

Show online status

enable_followersboolean

Allow people to follow you

accept_pmsstring

everyonewhitelisted

show_location_based_recommendationsboolean
activity_relevant_adsboolean
third_party_data_personalized_adsboolean
third_party_site_data_personalized_adsboolean
third_party_site_data_personalized_contentboolean
allow_clicktrackingboolean
mediastring

onoffsubreddit

media_previewstring

onoffsubreddit

nightmodeboolean
default_comment_sortstring

confidencetopnewcontroversialoldrandomqalive

ignore_suggested_sortboolean
send_welcome_messagesboolean
email_messagesboolean
email_unsubscribe_allboolean
feed_recommendations_enabledboolean
top_karma_subredditsboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/reddit/preferences
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

Trophies

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

Try it with MCPAsk your agent to call reddit-trophies-list (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 6 item attributes
idstring
namestring
descriptionstring | null
icon_urlstring (uri) | null
granted_atstring (date-time) | null
urlstring (uri) | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

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

Friends

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

Try it with MCPAsk your agent to call reddit-friends-list (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 5 item attributes
idstring

username

usernamestring
user_idstring | null
sincestring (date-time) | null
notestring | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-friends-create (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

usernamestringrequired

≥ 1 characters

Returns object

idstring

username

usernamestring
user_idstring | null
sincestring (date-time) | null
notestring | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/friends
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

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

Try it with MCPAsk your agent to call reddit-friends-delete (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

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

Blocked users

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

Try it with MCPAsk your agent to call reddit-blocked-users-list (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 5 item attributes
idstring

username

usernamestring
user_idstring | null
sincestring (date-time) | null
notestring | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-blocked-users-create (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

usernamestringrequired

≥ 1 characters

Returns object

idstring

username

usernamestring
user_idstring | null
sincestring (date-time) | null
notestring | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/blocked-users
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

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

Try it with MCPAsk your agent to call reddit-blocked-users-delete (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

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

My posts

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: readZernio: GET /v1/accounts/{accountId}/postsGET /v1/inbox/comments

Try it with MCPAsk your agent to call reddit-my-posts-list (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (Reddit after fullname)

limitintegerdefault: 25

1–100

sortstringdefault: "new"

newhottopcontroversial

tstring

Time filter for top/controversial

hourdayweekmonthyearall

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 36 item attributes
idstringrequired

t3_ fullname

short_idstring
titlestringrequired

≤ 300 characters

textstring

Markdown body (self posts)

urlstring (uri) | null
permalinkstring (uri)
subredditstring
authorstring
created_atstring (date-time)
edited_atstring (date-time) | null
scoreinteger
upvote_rationumber | null

0–1

num_commentsinteger
num_crosspostsinteger
awardsinteger
view_countinteger | null
kindstring

selflinkimagevideogallerypollcrosspost

domainstring | null
thumbnailstring (uri) | null
flair_textstring | null
flair_template_idstring | null
over_18boolean
spoilerboolean
lockedboolean
stickiedboolean
archivedboolean
distinguishedstring | null
send_repliesboolean | null
savedboolean
hiddenboolean
my_voteinteger

-101

removed_by_categorystring | null
num_reportsinteger | null
pollobject | null
Show 3 child attributes
total_votesinteger | null
ends_atstring (date-time) | null
optionsarray of object
Show 3 item attributes
idstring
textstring
votesinteger | null
galleryarray of object | null
Show 4 item attributes
media_idstring
captionstring | null
outbound_urlstring (uri) | null
urlstring (uri) | null
video_urlstring (uri) | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

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

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: writeIdempotency-KeyZernio: POST /v1/posts/{postId}/editPOST /v1/posts/{postId}/unpublishPOST /v1/accounts/{accountId}/reddit-flairs

Try it with MCPAsk your agent to call reddit-my-posts-create (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

subredditstringrequired

Subreddit name without r/

≥ 1 characters

titlestringrequired

1–300 characters

textstring

Markdown body. Use {media1}… placeholders to position inline media.

kindstringdefault: "auto"

autoselflinkimagevideovideogifgallerypollcrosspost

urlstring (uri)

Link post URL

mediaarray of string

≤ 20 items

flairIdstring

≤ 36 characters

flairTextstring

≤ 64 characters

nsfwbooleandefault: false
spoilerbooleandefault: false
sendRepliesbooleandefault: true
videogifboolean
nativeVideobooleandefault: true
bodyWithMediastringdefault: "inline"

inlinecommentdrop

pollobject
Show 2 child attributes
optionsarray of string

2–6 items

durationintegerdefault: 3

1–7

crosspostOfstring

t3_ id or permalink

collectionIdstring
firstCommentstring
firstCommentStickyboolean

Returns object

idstringrequired

t3_ fullname

short_idstring
titlestringrequired

≤ 300 characters

textstring

Markdown body (self posts)

urlstring (uri) | null
permalinkstring (uri)
subredditstring
authorstring
created_atstring (date-time)
edited_atstring (date-time) | null
scoreinteger
upvote_rationumber | null

0–1

num_commentsinteger
num_crosspostsinteger
awardsinteger
view_countinteger | null
kindstring

selflinkimagevideogallerypollcrosspost

domainstring | null
thumbnailstring (uri) | null
flair_textstring | null
flair_template_idstring | null
over_18boolean
spoilerboolean
lockedboolean
stickiedboolean
archivedboolean
distinguishedstring | null
send_repliesboolean | null
savedboolean
hiddenboolean
my_voteinteger

-101

removed_by_categorystring | null
num_reportsinteger | null
pollobject | null
Show 3 child attributes
total_votesinteger | null
ends_atstring (date-time) | null
optionsarray of object
Show 3 item attributes
idstring
textstring
votesinteger | null
galleryarray of object | null
Show 4 item attributes
media_idstring
captionstring | null
outbound_urlstring (uri) | null
urlstring (uri) | null
video_urlstring (uri) | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/my-posts
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

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

Try it with MCPAsk your agent to call reddit-my-posts-get (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringrequired

t3_ fullname

short_idstring
titlestringrequired

≤ 300 characters

textstring

Markdown body (self posts)

urlstring (uri) | null
permalinkstring (uri)
subredditstring
authorstring
created_atstring (date-time)
edited_atstring (date-time) | null
scoreinteger
upvote_rationumber | null

0–1

num_commentsinteger
num_crosspostsinteger
awardsinteger
view_countinteger | null
kindstring

selflinkimagevideogallerypollcrosspost

domainstring | null
thumbnailstring (uri) | null
flair_textstring | null
flair_template_idstring | null
over_18boolean
spoilerboolean
lockedboolean
stickiedboolean
archivedboolean
distinguishedstring | null
send_repliesboolean | null
savedboolean
hiddenboolean
my_voteinteger

-101

removed_by_categorystring | null
num_reportsinteger | null
pollobject | null
Show 3 child attributes
total_votesinteger | null
ends_atstring (date-time) | null
optionsarray of object
Show 3 item attributes
idstring
textstring
votesinteger | null
galleryarray of object | null
Show 4 item attributes
media_idstring
captionstring | null
outbound_urlstring (uri) | null
urlstring (uri) | null
video_urlstring (uri) | null

Responses

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

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

Try it with MCPAsk your agent to call reddit-my-posts-update (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

textstring
nsfwboolean
spoilerboolean
sendRepliesboolean
flairIdstring
flairTextstring

Returns object

idstringrequired

t3_ fullname

short_idstring
titlestringrequired

≤ 300 characters

textstring

Markdown body (self posts)

urlstring (uri) | null
permalinkstring (uri)
subredditstring
authorstring
created_atstring (date-time)
edited_atstring (date-time) | null
scoreinteger
upvote_rationumber | null

0–1

num_commentsinteger
num_crosspostsinteger
awardsinteger
view_countinteger | null
kindstring

selflinkimagevideogallerypollcrosspost

domainstring | null
thumbnailstring (uri) | null
flair_textstring | null
flair_template_idstring | null
over_18boolean
spoilerboolean
lockedboolean
stickiedboolean
archivedboolean
distinguishedstring | null
send_repliesboolean | null
savedboolean
hiddenboolean
my_voteinteger

-101

removed_by_categorystring | null
num_reportsinteger | null
pollobject | null
Show 3 child attributes
total_votesinteger | null
ends_atstring (date-time) | null
optionsarray of object
Show 3 item attributes
idstring
textstring
votesinteger | null
galleryarray of object | null
Show 4 item attributes
media_idstring
captionstring | null
outbound_urlstring (uri) | null
urlstring (uri) | null
video_urlstring (uri) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/reddit/my-posts/{itemId}
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

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

Try it with MCPAsk your agent to call reddit-my-posts-delete (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-my-posts-set-flair (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

flairTemplateIdstring
textstring

≤ 64 characters

subredditstring

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/my-posts/{itemId}/set-flair
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-my-posts-toggle-replies (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

statebooleanrequired

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/my-posts/{itemId}/toggle-replies
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-my-posts-comment (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

textstringrequired

≥ 1 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/my-posts/{itemId}/comment
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-my-posts-reconcile (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

titlestringrequired
subredditstringrequired
submittedAtstring (date-time)

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/my-posts/reconcile
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-my-posts-vote (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

directionintegerrequired

10-1

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/my-posts/{itemId}/vote
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-my-posts-save (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

categorystring

Saved category (Reddit Premium)

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/my-posts/{itemId}/save
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-my-posts-unsave (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/my-posts/{itemId}/unsave
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-my-posts-report (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

reasonstring

Reason text

≤ 100 characters

rule_reasonstring

Subreddit rule short_name

site_reasonstring

Site-wide rule

custom_textstring

≤ 2000 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/my-posts/{itemId}/report
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-my-posts-hide (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/my-posts/{itemId}/hide
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-my-posts-unhide (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/my-posts/{itemId}/unhide
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-my-posts-follow (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

followbooleandefault: true

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/my-posts/{itemId}/follow
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-my-posts-crosspost (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

subredditstringrequired

Subreddit name without r/

≥ 1 characters

titlestringrequired

≤ 300 characters

nsfwboolean
spoilerboolean
flairIdstring
flairTextstring
sendRepliesbooleandefault: true

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/my-posts/{itemId}/crosspost
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

My comments

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

Try it with MCPAsk your agent to call reddit-my-comments-list (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (Reddit after fullname)

limitintegerdefault: 25

1–100

sortstringdefault: "new"

newhottopcontroversial

tstring

Time filter for top/controversial

hourdayweekmonthyearall

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 22 item attributes
idstringrequired

t1_ fullname

textstring
authorstring
created_atstring (date-time)
edited_atstring (date-time) | null
scoreinteger
like_countinteger
parent_idstring

t3_ (top level) or t1_ parent

post_idstring
post_titlestring | null
subredditstring
permalinkstring (uri)
depthinteger
replies_countinteger
is_submitterboolean
is_ownboolean | null
distinguishedstring | null
stickiedboolean
lockedboolean
savedboolean
my_voteinteger

-101

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

Responses

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

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

Try it with MCPAsk your agent to call reddit-my-comments-update (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

textstringrequired

≥ 1 characters

Returns object

idstringrequired

t1_ fullname

textstring
authorstring
created_atstring (date-time)
edited_atstring (date-time) | null
scoreinteger
like_countinteger
parent_idstring

t3_ (top level) or t1_ parent

post_idstring
post_titlestring | null
subredditstring
permalinkstring (uri)
depthinteger
replies_countinteger
is_submitterboolean
is_ownboolean | null
distinguishedstring | null
stickiedboolean
lockedboolean
savedboolean
my_voteinteger

-101

removedboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/reddit/my-comments/{itemId}
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

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

Try it with MCPAsk your agent to call reddit-my-comments-delete (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-my-comments-pin (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

pinbooleandefault: true

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/my-comments/{itemId}/pin
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-my-comments-vote (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

directionintegerrequired

10-1

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/my-comments/{itemId}/vote
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-my-comments-save (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

categorystring

Saved category (Reddit Premium)

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/my-comments/{itemId}/save
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-my-comments-unsave (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/my-comments/{itemId}/unsave
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-my-comments-report (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

reasonstring

Reason text

≤ 100 characters

rule_reasonstring

Subreddit rule short_name

site_reasonstring

Site-wide rule

custom_textstring

≤ 2000 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/my-comments/{itemId}/report
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

Saved

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

Try it with MCPAsk your agent to call reddit-saved-list (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (Reddit after fullname)

limitintegerdefault: 25

1–100

typestring

linkscomments

categorystring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 45 item attributes
idstringrequired

t1_ fullname

short_idstring
titlestring

≤ 300 characters

textstring
urlstring (uri) | null
permalinkstring (uri)
subredditstring
authorstring
created_atstring (date-time)
edited_atstring (date-time) | null
scoreinteger
upvote_rationumber | null

0–1

num_commentsinteger
num_crosspostsinteger
awardsinteger
view_countinteger | null
kindstring

postcomment

domainstring | null
thumbnailstring (uri) | null
flair_textstring | null
flair_template_idstring | null
over_18boolean
spoilerboolean
lockedboolean
stickiedboolean
archivedboolean
distinguishedstring | null
send_repliesboolean | null
savedboolean
hiddenboolean
my_voteinteger

-101

removed_by_categorystring | null
num_reportsinteger | null
pollobject | null
Show 3 child attributes
total_votesinteger | null
ends_atstring (date-time) | null
optionsarray of object
Show 3 item attributes
idstring
textstring
votesinteger | null
galleryarray of object | null
Show 4 item attributes
media_idstring
captionstring | null
outbound_urlstring (uri) | null
urlstring (uri) | null
video_urlstring (uri) | null
like_countinteger
parent_idstring

t3_ (top level) or t1_ parent

post_idstring
post_titlestring | null
depthinteger
replies_countinteger
is_submitterboolean
is_ownboolean | null
removedboolean
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

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

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

Try it with MCPAsk your agent to call reddit-saved-delete (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-saved-categories (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/saved/categories
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-saved-save (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

idstringrequired
categorystring

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/saved/save
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

Hidden

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

Try it with MCPAsk your agent to call reddit-hidden-list (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (Reddit after fullname)

limitintegerdefault: 25

1–100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 36 item attributes
idstringrequired

t3_ fullname

short_idstring
titlestringrequired

≤ 300 characters

textstring

Markdown body (self posts)

urlstring (uri) | null
permalinkstring (uri)
subredditstring
authorstring
created_atstring (date-time)
edited_atstring (date-time) | null
scoreinteger
upvote_rationumber | null

0–1

num_commentsinteger
num_crosspostsinteger
awardsinteger
view_countinteger | null
kindstring

selflinkimagevideogallerypollcrosspost

domainstring | null
thumbnailstring (uri) | null
flair_textstring | null
flair_template_idstring | null
over_18boolean
spoilerboolean
lockedboolean
stickiedboolean
archivedboolean
distinguishedstring | null
send_repliesboolean | null
savedboolean
hiddenboolean
my_voteinteger

-101

removed_by_categorystring | null
num_reportsinteger | null
pollobject | null
Show 3 child attributes
total_votesinteger | null
ends_atstring (date-time) | null
optionsarray of object
Show 3 item attributes
idstring
textstring
votesinteger | null
galleryarray of object | null
Show 4 item attributes
media_idstring
captionstring | null
outbound_urlstring (uri) | null
urlstring (uri) | null
video_urlstring (uri) | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

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

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

Try it with MCPAsk your agent to call reddit-hidden-delete (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

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

Voted

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

Try it with MCPAsk your agent to call reddit-voted-list (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (Reddit after fullname)

limitintegerdefault: 25

1–100

directionstringdefault: "up"

updown

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 36 item attributes
idstringrequired

t3_ fullname

short_idstring
titlestringrequired

≤ 300 characters

textstring

Markdown body (self posts)

urlstring (uri) | null
permalinkstring (uri)
subredditstring
authorstring
created_atstring (date-time)
edited_atstring (date-time) | null
scoreinteger
upvote_rationumber | null

0–1

num_commentsinteger
num_crosspostsinteger
awardsinteger
view_countinteger | null
kindstring

selflinkimagevideogallerypollcrosspost

domainstring | null
thumbnailstring (uri) | null
flair_textstring | null
flair_template_idstring | null
over_18boolean
spoilerboolean
lockedboolean
stickiedboolean
archivedboolean
distinguishedstring | null
send_repliesboolean | null
savedboolean
hiddenboolean
my_voteinteger

-101

removed_by_categorystring | null
num_reportsinteger | null
pollobject | null
Show 3 child attributes
total_votesinteger | null
ends_atstring (date-time) | null
optionsarray of object
Show 3 item attributes
idstring
textstring
votesinteger | null
galleryarray of object | null
Show 4 item attributes
media_idstring
captionstring | null
outbound_urlstring (uri) | null
urlstring (uri) | null
video_urlstring (uri) | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

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

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

Try it with MCPAsk your agent to call reddit-voted-delete (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

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

Overview

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

Try it with MCPAsk your agent to call reddit-overview-list (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (Reddit after fullname)

limitintegerdefault: 25

1–100

sortstringdefault: "new"

newhottopcontroversial

tstring

Time filter for top/controversial

hourdayweekmonthyearall

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 45 item attributes
idstringrequired

t1_ fullname

short_idstring
titlestring

≤ 300 characters

textstring
urlstring (uri) | null
permalinkstring (uri)
subredditstring
authorstring
created_atstring (date-time)
edited_atstring (date-time) | null
scoreinteger
upvote_rationumber | null

0–1

num_commentsinteger
num_crosspostsinteger
awardsinteger
view_countinteger | null
kindstring

postcomment

domainstring | null
thumbnailstring (uri) | null
flair_textstring | null
flair_template_idstring | null
over_18boolean
spoilerboolean
lockedboolean
stickiedboolean
archivedboolean
distinguishedstring | null
send_repliesboolean | null
savedboolean
hiddenboolean
my_voteinteger

-101

removed_by_categorystring | null
num_reportsinteger | null
pollobject | null
Show 3 child attributes
total_votesinteger | null
ends_atstring (date-time) | null
optionsarray of object
Show 3 item attributes
idstring
textstring
votesinteger | null
galleryarray of object | null
Show 4 item attributes
media_idstring
captionstring | null
outbound_urlstring (uri) | null
urlstring (uri) | null
video_urlstring (uri) | null
like_countinteger
parent_idstring

t3_ (top level) or t1_ parent

post_idstring
post_titlestring | null
depthinteger
replies_countinteger
is_submitterboolean
is_ownboolean | null
removedboolean
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

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

My subreddits

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: readZernio: GET /v1/accounts/{accountId}/reddit-subreddits

Try it with MCPAsk your agent to call reddit-my-subreddits-list (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (Reddit after fullname)

limitintegerdefault: 25

1–100

wherestringdefault: "postable"

postablesubscribermoderatorcontributorstreams

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 22 item attributes
idstring | null

t5_ fullname

namestringrequired
prefixed_namestring
titlestring | null
descriptionstring | null
subscribersinteger | null
active_usersinteger | null
typestring | null

publicprivaterestrictedgold_restrictedarchivedemployees_onlygold_onlyuser

over_18boolean
submission_typestring

anylinkself

post_typesobject
Show 8 child attributes
selfboolean
linkboolean
imageboolean
videoboolean
galleryboolean
videogifboolean
pollboolean
crosspostboolean
spoilers_enabledboolean
link_flair_enabledboolean
restrict_postingboolean
user_is_subscriberboolean
user_is_moderatorboolean
user_is_contributorboolean
user_is_bannedboolean
icon_urlstring (uri) | null
banner_urlstring (uri) | null
urlstring (uri) | null
created_atstring (date-time) | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-my-subreddits-create (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

subredditstringrequired

Subreddit name without r/

≥ 1 characters

Returns object

idstring | null

t5_ fullname

namestringrequired
prefixed_namestring
titlestring | null
descriptionstring | null
subscribersinteger | null
active_usersinteger | null
typestring | null

publicprivaterestrictedgold_restrictedarchivedemployees_onlygold_onlyuser

over_18boolean
submission_typestring

anylinkself

post_typesobject
Show 8 child attributes
selfboolean
linkboolean
imageboolean
videoboolean
galleryboolean
videogifboolean
pollboolean
crosspostboolean
spoilers_enabledboolean
link_flair_enabledboolean
restrict_postingboolean
user_is_subscriberboolean
user_is_moderatorboolean
user_is_contributorboolean
user_is_bannedboolean
icon_urlstring (uri) | null
banner_urlstring (uri) | null
urlstring (uri) | null
created_atstring (date-time) | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/my-subreddits
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

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

Try it with MCPAsk your agent to call reddit-my-subreddits-get (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstring | null

t5_ fullname

namestringrequired
prefixed_namestring
titlestring | null
descriptionstring | null
subscribersinteger | null
active_usersinteger | null
typestring | null

publicprivaterestrictedgold_restrictedarchivedemployees_onlygold_onlyuser

over_18boolean
submission_typestring

anylinkself

post_typesobject
Show 8 child attributes
selfboolean
linkboolean
imageboolean
videoboolean
galleryboolean
videogifboolean
pollboolean
crosspostboolean
spoilers_enabledboolean
link_flair_enabledboolean
restrict_postingboolean
user_is_subscriberboolean
user_is_moderatorboolean
user_is_contributorboolean
user_is_bannedboolean
icon_urlstring (uri) | null
banner_urlstring (uri) | null
urlstring (uri) | null
created_atstring (date-time) | null

Responses

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

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

Try it with MCPAsk your agent to call reddit-my-subreddits-delete (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

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

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: writeIdempotency-KeyZernio: PUT /v1/accounts/{accountId}/reddit-subreddits

Try it with MCPAsk your agent to call reddit-my-subreddits-set-default (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/my-subreddits/{itemId}/set-default
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

Subreddits

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: readZernio: GET /v1/tools/validate/subreddit

Try it with MCPAsk your agent to call reddit-subreddits-list (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (Reddit after fullname)

limitintegerdefault: 25

1–100

qstring

Search text (otherwise browse where)

wherestringdefault: "popular"

popularnewdefaultgold

include_nsfwbooleandefault: false

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 22 item attributes
idstring | null

t5_ fullname

namestringrequired
prefixed_namestring
titlestring | null
descriptionstring | null
subscribersinteger | null
active_usersinteger | null
typestring | null

publicprivaterestrictedgold_restrictedarchivedemployees_onlygold_onlyuser

over_18boolean
submission_typestring

anylinkself

post_typesobject
Show 8 child attributes
selfboolean
linkboolean
imageboolean
videoboolean
galleryboolean
videogifboolean
pollboolean
crosspostboolean
spoilers_enabledboolean
link_flair_enabledboolean
restrict_postingboolean
user_is_subscriberboolean
user_is_moderatorboolean
user_is_contributorboolean
user_is_bannedboolean
icon_urlstring (uri) | null
banner_urlstring (uri) | null
urlstring (uri) | null
created_atstring (date-time) | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

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

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

Try it with MCPAsk your agent to call reddit-subreddits-get (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Query parameters

include_requirementsbooleandefault: false

Returns object

idstring | null

t5_ fullname

namestringrequired
prefixed_namestring
titlestring | null
descriptionstring | null
subscribersinteger | null
active_usersinteger | null
typestring | null

publicprivaterestrictedgold_restrictedarchivedemployees_onlygold_onlyuser

over_18boolean
submission_typestring

anylinkself

post_typesobject
Show 8 child attributes
selfboolean
linkboolean
imageboolean
videoboolean
galleryboolean
videogifboolean
pollboolean
crosspostboolean
spoilers_enabledboolean
link_flair_enabledboolean
restrict_postingboolean
user_is_subscriberboolean
user_is_moderatorboolean
user_is_contributorboolean
user_is_bannedboolean
icon_urlstring (uri) | null
banner_urlstring (uri) | null
urlstring (uri) | null
created_atstring (date-time) | null

Responses

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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-subreddits-subscribe (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/subreddits/{itemId}/subscribe
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-subreddits-unsubscribe (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/subreddits/{itemId}/unsubscribe
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-subreddits-requirements (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/subreddits/{itemId}/requirements
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-subreddits-submit-text (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/subreddits/{itemId}/submit-text
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-subreddits-sidebar (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/subreddits/{itemId}/sidebar
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

Feed

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

Try it with MCPAsk your agent to call reddit-feed-get (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringrequired

t3_ fullname

short_idstring
titlestringrequired

≤ 300 characters

textstring

Markdown body (self posts)

urlstring (uri) | null
permalinkstring (uri)
subredditstring
authorstring
created_atstring (date-time)
edited_atstring (date-time) | null
scoreinteger
upvote_rationumber | null

0–1

num_commentsinteger
num_crosspostsinteger
awardsinteger
view_countinteger | null
kindstring

selflinkimagevideogallerypollcrosspost

domainstring | null
thumbnailstring (uri) | null
flair_textstring | null
flair_template_idstring | null
over_18boolean
spoilerboolean
lockedboolean
stickiedboolean
archivedboolean
distinguishedstring | null
send_repliesboolean | null
savedboolean
hiddenboolean
my_voteinteger

-101

removed_by_categorystring | null
num_reportsinteger | null
pollobject | null
Show 3 child attributes
total_votesinteger | null
ends_atstring (date-time) | null
optionsarray of object
Show 3 item attributes
idstring
textstring
votesinteger | null
galleryarray of object | null
Show 4 item attributes
media_idstring
captionstring | null
outbound_urlstring (uri) | null
urlstring (uri) | null
video_urlstring (uri) | null

Responses

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

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: writeIdempotency-KeyZernio: POST /v1/accounts/{accountId}/reddit-vote

Try it with MCPAsk your agent to call reddit-feed-vote (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

directionintegerrequired

10-1

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/feed/{itemId}/vote
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-feed-save (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

categorystring

Saved category (Reddit Premium)

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/feed/{itemId}/save
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-feed-unsave (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/feed/{itemId}/unsave
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-feed-report (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

reasonstring

Reason text

≤ 100 characters

rule_reasonstring

Subreddit rule short_name

site_reasonstring

Site-wide rule

custom_textstring

≤ 2000 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/feed/{itemId}/report
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-feed-hide (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/feed/{itemId}/hide
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-feed-unhide (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/feed/{itemId}/unhide
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-feed-follow (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

followbooleandefault: true

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/feed/{itemId}/follow
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-feed-crosspost (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

subredditstringrequired

Subreddit name without r/

≥ 1 characters

titlestringrequired

≤ 300 characters

nsfwboolean
spoilerboolean
flairIdstring
flairTextstring
sendRepliesbooleandefault: true

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/feed/{itemId}/crosspost
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-feed-approve (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/feed/{itemId}/approve
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

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

Try it with MCPAsk your agent to call reddit-feed-remove (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

spambooleandefault: false
reason_idstring

Removal reason id

mod_notestring

Private note for the mod log

≤ 100 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/feed/{itemId}/remove
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-feed-send-removal-message (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

messagestringrequired

≥ 1 characters

typestringdefault: "public"

publicprivateprivate_exposed

titlestring

Subject (private messages)

≤ 50 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/feed/{itemId}/send-removal-message
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-feed-distinguish (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

howstringdefault: "yes"

yesnoadminspecial

stickyboolean

Sticky (top-level own comments only)

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/feed/{itemId}/distinguish
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-feed-ignore-reports (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/feed/{itemId}/ignore-reports
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-feed-unignore-reports (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/feed/{itemId}/unignore-reports
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-feed-snooze-reports (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

reasonstringrequired

Report reason to snooze for 7 days

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/feed/{itemId}/snooze-reports
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-feed-unsnooze-reports (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

reasonstringrequired

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/feed/{itemId}/unsnooze-reports
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-feed-lock (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/feed/{itemId}/lock
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-feed-unlock (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/feed/{itemId}/unlock
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-feed-mark-nsfw (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/feed/{itemId}/mark-nsfw
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-feed-unmark-nsfw (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/feed/{itemId}/unmark-nsfw
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-feed-spoiler (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/feed/{itemId}/spoiler
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-feed-unspoiler (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/feed/{itemId}/unspoiler
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-feed-sticky (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

statebooleandefault: true
numinteger

Highlight slot (1–6)

1–6

to_profileboolean

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/feed/{itemId}/sticky
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-feed-contest-mode (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

statebooleandefault: true

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/feed/{itemId}/contest-mode
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-feed-suggested-sort (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

sortstringrequired

confidencetopnewcontroversialoldrandomqaliveblank

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/feed/{itemId}/suggested-sort
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-feed-crowd-control (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

levelintegerrequired

0–3

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/feed/{itemId}/crowd-control
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-feed-duplicates (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/feed/{itemId}/duplicates
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-search-vote (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

directionintegerrequired

10-1

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/search/{itemId}/vote
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-search-save (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

categorystring

Saved category (Reddit Premium)

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/search/{itemId}/save
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-search-unsave (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/search/{itemId}/unsave
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-search-report (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

reasonstring

Reason text

≤ 100 characters

rule_reasonstring

Subreddit rule short_name

site_reasonstring

Site-wide rule

custom_textstring

≤ 2000 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/search/{itemId}/report
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-search-hide (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/search/{itemId}/hide
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-search-unhide (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/search/{itemId}/unhide
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-search-follow (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

followbooleandefault: true

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/search/{itemId}/follow
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-search-crosspost (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

subredditstringrequired

Subreddit name without r/

≥ 1 characters

titlestringrequired

≤ 300 characters

nsfwboolean
spoilerboolean
flairIdstring
flairTextstring
sendRepliesbooleandefault: true

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/search/{itemId}/crosspost
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-search-approve (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/search/{itemId}/approve
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

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

Try it with MCPAsk your agent to call reddit-search-remove (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

spambooleandefault: false
reason_idstring

Removal reason id

mod_notestring

Private note for the mod log

≤ 100 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/search/{itemId}/remove
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-search-send-removal-message (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

messagestringrequired

≥ 1 characters

typestringdefault: "public"

publicprivateprivate_exposed

titlestring

Subject (private messages)

≤ 50 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/search/{itemId}/send-removal-message
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-search-distinguish (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

howstringdefault: "yes"

yesnoadminspecial

stickyboolean

Sticky (top-level own comments only)

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/search/{itemId}/distinguish
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-search-ignore-reports (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/search/{itemId}/ignore-reports
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-search-unignore-reports (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/search/{itemId}/unignore-reports
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-search-snooze-reports (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

reasonstringrequired

Report reason to snooze for 7 days

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/search/{itemId}/snooze-reports
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-search-unsnooze-reports (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

reasonstringrequired

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/search/{itemId}/unsnooze-reports
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-search-lock (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/search/{itemId}/lock
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-search-unlock (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/search/{itemId}/unlock
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-search-mark-nsfw (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/search/{itemId}/mark-nsfw
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-search-unmark-nsfw (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/search/{itemId}/unmark-nsfw
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-search-spoiler (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/search/{itemId}/spoiler
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-search-unspoiler (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/search/{itemId}/unspoiler
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-search-sticky (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

statebooleandefault: true
numinteger

Highlight slot (1–6)

1–6

to_profileboolean

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/search/{itemId}/sticky
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-search-contest-mode (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

statebooleandefault: true

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/search/{itemId}/contest-mode
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-search-suggested-sort (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

sortstringrequired

confidencetopnewcontroversialoldrandomqaliveblank

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/search/{itemId}/suggested-sort
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-search-crowd-control (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

levelintegerrequired

0–3

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/search/{itemId}/crowd-control
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

Post comments

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: readZernio: GET /v1/reddit/comments/{postId}GET /v1/inbox/comments/{postId}

Try it with MCPAsk your agent to call reddit-post-comments-list (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

post_idstring

t3_ id, base36 id or permalink

≥ 1 characters

sortstringdefault: "best"

besttopnewcontroversialoldqa

comment_idstring

Focus a sub-thread

depthinteger

1–10

limitintegerdefault: 100

1–500

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 22 item attributes
idstringrequired

t1_ fullname

textstring
authorstring
created_atstring (date-time)
edited_atstring (date-time) | null
scoreinteger
like_countinteger
parent_idstring

t3_ (top level) or t1_ parent

post_idstring
post_titlestring | null
subredditstring
permalinkstring (uri)
depthinteger
replies_countinteger
is_submitterboolean
is_ownboolean | null
distinguishedstring | null
stickiedboolean
lockedboolean
savedboolean
my_voteinteger

-101

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

Responses

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

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: writeIdempotency-KeyZernio: POST /v1/inbox/comments/{postId}POST /v1/inbox/comments/{postId}/{commentId}/likePOST /v1/inbox/comments/{postId}/{commentId}/pin

Try it with MCPAsk your agent to call reddit-post-comments-create (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

parent_idstringrequired

t3_ (post) or t1_ (comment) to reply to

textstringrequired

≥ 1 characters

Returns object

idstringrequired

t1_ fullname

textstring
authorstring
created_atstring (date-time)
edited_atstring (date-time) | null
scoreinteger
like_countinteger
parent_idstring

t3_ (top level) or t1_ parent

post_idstring
post_titlestring | null
subredditstring
permalinkstring (uri)
depthinteger
replies_countinteger
is_submitterboolean
is_ownboolean | null
distinguishedstring | null
stickiedboolean
lockedboolean
savedboolean
my_voteinteger

-101

removedboolean

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/post-comments
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

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: writeZernio: PATCH /v1/inbox/comments/{postId}/{commentId}

Try it with MCPAsk your agent to call reddit-post-comments-update (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

textstringrequired

≥ 1 characters

Returns object

idstringrequired

t1_ fullname

textstring
authorstring
created_atstring (date-time)
edited_atstring (date-time) | null
scoreinteger
like_countinteger
parent_idstring

t3_ (top level) or t1_ parent

post_idstring
post_titlestring | null
subredditstring
permalinkstring (uri)
depthinteger
replies_countinteger
is_submitterboolean
is_ownboolean | null
distinguishedstring | null
stickiedboolean
lockedboolean
savedboolean
my_voteinteger

-101

removedboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/reddit/post-comments/{itemId}
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

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: writeZernio: DELETE /v1/inbox/comments/{postId}DELETE /v1/inbox/comments/{postId}/{commentId}/likeDELETE /v1/inbox/comments/{postId}/{commentId}/pin

Try it with MCPAsk your agent to call reddit-post-comments-delete (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-post-comments-reply (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

textstringrequired

≥ 1 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/post-comments/{itemId}/reply
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-post-comments-load-more (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

post_idstringrequired
childrenarray of stringrequired
sortstring

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/post-comments/load-more
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-post-comments-vote (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

directionintegerrequired

10-1

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/post-comments/{itemId}/vote
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-post-comments-save (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

categorystring

Saved category (Reddit Premium)

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/post-comments/{itemId}/save
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-post-comments-unsave (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/post-comments/{itemId}/unsave
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-post-comments-report (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

reasonstring

Reason text

≤ 100 characters

rule_reasonstring

Subreddit rule short_name

site_reasonstring

Site-wide rule

custom_textstring

≤ 2000 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/post-comments/{itemId}/report
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-post-comments-approve (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/post-comments/{itemId}/approve
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

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

Try it with MCPAsk your agent to call reddit-post-comments-remove (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

spambooleandefault: false
reason_idstring

Removal reason id

mod_notestring

Private note for the mod log

≤ 100 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/post-comments/{itemId}/remove
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-post-comments-send-removal-message (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

messagestringrequired

≥ 1 characters

typestringdefault: "public"

publicprivateprivate_exposed

titlestring

Subject (private messages)

≤ 50 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/post-comments/{itemId}/send-removal-message
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-post-comments-distinguish (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

howstringdefault: "yes"

yesnoadminspecial

stickyboolean

Sticky (top-level own comments only)

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/post-comments/{itemId}/distinguish
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-post-comments-ignore-reports (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/post-comments/{itemId}/ignore-reports
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-post-comments-unignore-reports (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/post-comments/{itemId}/unignore-reports
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-post-comments-snooze-reports (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

reasonstringrequired

Report reason to snooze for 7 days

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/post-comments/{itemId}/snooze-reports
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-post-comments-unsnooze-reports (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

reasonstringrequired

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/post-comments/{itemId}/unsnooze-reports
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-post-comments-lock (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/post-comments/{itemId}/lock
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-post-comments-unlock (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/post-comments/{itemId}/unlock
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-post-comments-show-comment (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/post-comments/{itemId}/show-comment
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

Subreddit rules

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: readZernio: GET /v1/accounts/{accountId}/reddit-subreddits/{subreddit}/rules

Try it with MCPAsk your agent to call reddit-subreddit-rules-list (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

subredditstring

Subreddit name without r/

≥ 1 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 7 item attributes
idstring

subreddit:short_name

priorityinteger
short_namestring

≤ 100 characters

descriptionstring | null

≤ 500 characters

violation_reasonstring | null

≤ 100 characters

kindstring

alllinkcomment

created_atstring (date-time) | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-subreddit-rules-create (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

subredditstringrequired

Subreddit name without r/

≥ 1 characters

short_namestringrequired

≤ 100 characters

descriptionstring

≤ 500 characters

kindstringdefault: "all"

alllinkcomment

violation_reasonstring

≤ 100 characters

Returns object

idstring

subreddit:short_name

priorityinteger
short_namestring

≤ 100 characters

descriptionstring | null

≤ 500 characters

violation_reasonstring | null

≤ 100 characters

kindstring

alllinkcomment

created_atstring (date-time) | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/subreddit-rules
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

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

Try it with MCPAsk your agent to call reddit-subreddit-rules-update (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

short_namestring

≤ 100 characters

descriptionstring

≤ 500 characters

kindstring

alllinkcomment

violation_reasonstring

≤ 100 characters

Returns object

idstring

subreddit:short_name

priorityinteger
short_namestring

≤ 100 characters

descriptionstring | null

≤ 500 characters

violation_reasonstring | null

≤ 100 characters

kindstring

alllinkcomment

created_atstring (date-time) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/reddit/subreddit-rules/{itemId}
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

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

Try it with MCPAsk your agent to call reddit-subreddit-rules-delete (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-subreddit-rules-reorder (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

subredditstringrequired

Subreddit name without r/

≥ 1 characters

orderarray of stringrequired

short_names in the new order

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/subreddit-rules/reorder
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

Post flairs

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: readZernio: GET /v1/accounts/{accountId}/reddit-flairs

Try it with MCPAsk your agent to call reddit-post-flairs-list (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

subredditstring

Subreddit name without r/

≥ 1 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 10 item attributes
idstring
textstring

≤ 64 characters

textColorstring | null

lightdark

backgroundColorstring | null

#rrggbb

textEditableboolean
typestring

textrichtext

modOnlyboolean
allowableContentstring

allemojitext

maxEmojisinteger | null

1–10

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

Responses

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

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: writeIdempotency-KeyZernio: POST /v1/accounts/{accountId}/reddit-flairs

Try it with MCPAsk your agent to call reddit-post-flairs-apply (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

subredditstring

Subreddit name without r/

≥ 1 characters

post_idstringrequired
textstring

≤ 64 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/post-flairs/{itemId}/apply
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

User flair

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

Try it with MCPAsk your agent to call reddit-user-flair-list (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

subredditstring

Subreddit name without r/

≥ 1 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 10 item attributes
idstring
textstring

≤ 64 characters

textColorstring | null

lightdark

backgroundColorstring | null

#rrggbb

textEditableboolean
typestring

textrichtext

modOnlyboolean
allowableContentstring

allemojitext

maxEmojisinteger | null

1–10

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

Responses

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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-user-flair-select (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

subredditstringrequired

Subreddit name without r/

≥ 1 characters

textstring

≤ 64 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/user-flair/{itemId}/select
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-user-flair-clear (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

subredditstringrequired

Subreddit name without r/

≥ 1 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/user-flair/clear
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-user-flair-toggle-display (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

subredditstringrequired

Subreddit name without r/

≥ 1 characters

enabledbooleanrequired

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/user-flair/toggle-display
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

Wiki

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

Try it with MCPAsk your agent to call reddit-wiki-list (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

subredditstring

Subreddit name without r/

≥ 1 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 9 item attributes
idstring

subreddit:page

subredditstring
pagestring
content_mdstring
revision_idstring | null
revision_bystring | null
revision_datestring (date-time) | null
reasonstring | null
may_reviseboolean | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-wiki-create (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

subredditstringrequired

Subreddit name without r/

≥ 1 characters

pagestringrequired

≥ 1 characters

contentstringrequired
reasonstring

≤ 256 characters

Returns object

idstring

subreddit:page

subredditstring
pagestring
content_mdstring
revision_idstring | null
revision_bystring | null
revision_datestring (date-time) | null
reasonstring | null
may_reviseboolean | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/wiki
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

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

Try it with MCPAsk your agent to call reddit-wiki-get (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Query parameters

revisionstring

Revision id (v)

Returns object

idstring

subreddit:page

subredditstring
pagestring
content_mdstring
revision_idstring | null
revision_bystring | null
revision_datestring (date-time) | null
reasonstring | null
may_reviseboolean | null

Responses

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

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

Try it with MCPAsk your agent to call reddit-wiki-update (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

contentstringrequired
reasonstring

≤ 256 characters

previousstring

Revision id the edit is based on (conflict detection)

Returns object

idstring

subreddit:page

subredditstring
pagestring
content_mdstring
revision_idstring | null
revision_bystring | null
revision_datestring (date-time) | null
reasonstring | null
may_reviseboolean | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/reddit/wiki/{itemId}
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-wiki-revisions (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/wiki/{itemId}/revisions
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

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

Try it with MCPAsk your agent to call reddit-wiki-revert (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

revisionstringrequired

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/wiki/{itemId}/revert
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-wiki-hide-revision (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

revisionstringrequired

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/wiki/{itemId}/hide-revision
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-wiki-settings (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/wiki/{itemId}/settings
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-wiki-update-settings (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

permlevelinteger

0 = subreddit settings, 1 = approved editors, 2 = mods only

012

listedboolean

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/wiki/{itemId}/update-settings
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-wiki-add-editor (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

usernamestringrequired

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/wiki/{itemId}/add-editor
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-wiki-remove-editor (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

usernamestringrequired

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/wiki/{itemId}/remove-editor
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

Custom feeds

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

Try it with MCPAsk your agent to call reddit-custom-feeds-list (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 10 item attributes
idstring
namestring
display_namestring
pathstring | null
descriptionstring | null
visibilitystring

privatepublichidden

subredditsarray of string
over_18boolean
icon_urlstring (uri) | null
created_atstring (date-time) | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-custom-feeds-create (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

namestringrequired

URL name

pattern ^[A-Za-z0-9_]{2,50}$

display_namestring

≤ 50 characters

descriptionstring
visibilitystringdefault: "private"

privatepublichidden

subredditsarray of string

Returns object

idstring
namestring
display_namestring
pathstring | null
descriptionstring | null
visibilitystring

privatepublichidden

subredditsarray of string
over_18boolean
icon_urlstring (uri) | null
created_atstring (date-time) | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/custom-feeds
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

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

Try it with MCPAsk your agent to call reddit-custom-feeds-get (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstring
namestring
display_namestring
pathstring | null
descriptionstring | null
visibilitystring

privatepublichidden

subredditsarray of string
over_18boolean
icon_urlstring (uri) | null
created_atstring (date-time) | null

Responses

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

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

Try it with MCPAsk your agent to call reddit-custom-feeds-update (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

namestring

URL name

pattern ^[A-Za-z0-9_]{2,50}$

display_namestring

≤ 50 characters

descriptionstring
visibilitystringdefault: "private"

privatepublichidden

subredditsarray of string

Returns object

idstring
namestring
display_namestring
pathstring | null
descriptionstring | null
visibilitystring

privatepublichidden

subredditsarray of string
over_18boolean
icon_urlstring (uri) | null
created_atstring (date-time) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/reddit/custom-feeds/{itemId}
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

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

Try it with MCPAsk your agent to call reddit-custom-feeds-delete (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-custom-feeds-add-subreddit (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

subredditstringrequired

Subreddit name without r/

≥ 1 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/custom-feeds/{itemId}/add-subreddit
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-custom-feeds-remove-subreddit (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

subredditstringrequired

Subreddit name without r/

≥ 1 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/custom-feeds/{itemId}/remove-subreddit
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

Inbox

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

Try it with MCPAsk your agent to call reddit-inbox-list (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (Reddit after fullname)

limitintegerdefault: 25

1–100

filterstringdefault: "inbox"

inboxunreadmessagescommentsselfreplymentions

mark_readbooleandefault: false

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 16 item attributes
idstringrequired

t1_ (comment/mention) or t4_ (message) fullname

typestringrequired

messagecomment_replypost_replymention

subjectstring | null
textstring
authorstring | null
tostring | null
created_atstring (date-time)
unreadboolean
directionstring

inout

conversation_idstring | null
parent_idstring | null
post_idstring | null
post_titlestring | null
subredditstring | null
permalinkstring (uri) | null
distinguishedstring | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-inbox-reply (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

textstringrequired

≥ 1 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/inbox/{itemId}/reply
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-inbox-mark-read (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/inbox/{itemId}/mark-read
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-inbox-mark-all-read (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/inbox/mark-all-read
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

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

Try it with MCPAsk your agent to call reddit-inbox-delete (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/inbox/{itemId}/delete
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

Messages

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: readZernio: GET /v1/inbox/conversationsGET /v1/inbox/conversations/{conversationId}/messages

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

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (Reddit after fullname)

limitintegerdefault: 25

1–100

include_sentbooleandefault: true

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 8 item attributes
idstring

Thread root t4_ fullname

subjectstring | null
updated_atstring (date-time) | null
unread_countinteger
last_messagestring | null
message_countinteger
participantsarray of object
Show 4 item attributes
idstring
namestring
usernamestring | null
subredditstring | null
messagesarray of object
Show 8 item attributes
idstring
textstring
directionstring

inout

sent_atstring (date-time)
from_idstring | null
to_idstring | null
subjectstring | null
unreadboolean
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

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

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: writeIdempotency-KeyZernio: POST /v1/inbox/conversationsPOST /v1/inbox/conversations/{conversationId}/messagesPOST /v1/inbox/conversations/{conversationId}/read

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

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

tostringrequired

username, u/username, or r/subreddit (messages its moderators)

subjectstring

≤ 100 characters

textstringrequired

≥ 1 characters

from_subredditstring

Send as a subreddit you moderate

Returns object

idstring

Thread root t4_ fullname

subjectstring | null
updated_atstring (date-time) | null
unread_countinteger
last_messagestring | null
message_countinteger
participantsarray of object
Show 4 item attributes
idstring
namestring
usernamestring | null
subredditstring | null
messagesarray of object
Show 8 item attributes
idstring
textstring
directionstring

inout

sent_atstring (date-time)
from_idstring | null
to_idstring | null
subjectstring | null
unreadboolean

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/messages
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

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: readZernio: GET /v1/inbox/conversations/{conversationId}

Try it with MCPAsk your agent to call reddit-messages-get (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstring

Thread root t4_ fullname

subjectstring | null
updated_atstring (date-time) | null
unread_countinteger
last_messagestring | null
message_countinteger
participantsarray of object
Show 4 item attributes
idstring
namestring
usernamestring | null
subredditstring | null
messagesarray of object
Show 8 item attributes
idstring
textstring
directionstring

inout

sent_atstring (date-time)
from_idstring | null
to_idstring | null
subjectstring | null
unreadboolean

Responses

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

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: writeZernio: DELETE /v1/inbox/conversations/{conversationId}/messages/{messageId}

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

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-messages-reply (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

textstringrequired

≥ 1 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/messages/{itemId}/reply
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-messages-mark-read (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/messages/{itemId}/mark-read
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-messages-mark-all-read (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/messages/mark-all-read
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

Mentions

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

Try it with MCPAsk your agent to call reddit-mentions-list (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (Reddit after fullname)

limitintegerdefault: 25

1–100

mark_readbooleandefault: false

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 16 item attributes
idstringrequired

t1_ (comment/mention) or t4_ (message) fullname

typestringrequired

messagecomment_replypost_replymention

subjectstring | null
textstring
authorstring | null
tostring | null
created_atstring (date-time)
unreadboolean
directionstring

inout

conversation_idstring | null
parent_idstring | null
post_idstring | null
post_titlestring | null
subredditstring | null
permalinkstring (uri) | null
distinguishedstring | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-mentions-reply (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

textstringrequired

≥ 1 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/mentions/{itemId}/reply
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-mentions-mark-read (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/mentions/{itemId}/mark-read
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-mentions-mark-all-read (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/mentions/mark-all-read
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-mentions-vote (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

directionintegerrequired

10-1

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/mentions/{itemId}/vote
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-mentions-save (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

categorystring

Saved category (Reddit Premium)

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/mentions/{itemId}/save
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-mentions-unsave (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/mentions/{itemId}/unsave
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-mentions-report (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

reasonstring

Reason text

≤ 100 characters

rule_reasonstring

Subreddit rule short_name

site_reasonstring

Site-wide rule

custom_textstring

≤ 2000 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/mentions/{itemId}/report
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

Replies

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

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

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (Reddit after fullname)

limitintegerdefault: 25

1–100

filterstringdefault: "comments"

commentsselfreply

mark_readbooleandefault: false

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 16 item attributes
idstringrequired

t1_ (comment/mention) or t4_ (message) fullname

typestringrequired

messagecomment_replypost_replymention

subjectstring | null
textstring
authorstring | null
tostring | null
created_atstring (date-time)
unreadboolean
directionstring

inout

conversation_idstring | null
parent_idstring | null
post_idstring | null
post_titlestring | null
subredditstring | null
permalinkstring (uri) | null
distinguishedstring | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-replies-reply (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

textstringrequired

≥ 1 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/replies/{itemId}/reply
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-replies-mark-read (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/replies/{itemId}/mark-read
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-replies-mark-all-read (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/replies/mark-all-read
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-replies-vote (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

directionintegerrequired

10-1

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/replies/{itemId}/vote
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-replies-save (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

categorystring

Saved category (Reddit Premium)

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/replies/{itemId}/save
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-replies-unsave (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/replies/{itemId}/unsave
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

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: writeIdempotency-Key

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

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

reasonstring

Reason text

≤ 100 characters

rule_reasonstring

Subreddit rule short_name

site_reasonstring

Site-wide rule

custom_textstring

≤ 2000 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/replies/{itemId}/report
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

Sent

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

Try it with MCPAsk your agent to call reddit-sent-list (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (Reddit after fullname)

limitintegerdefault: 25

1–100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 16 item attributes
idstringrequired

t1_ (comment/mention) or t4_ (message) fullname

typestringrequired

messagecomment_replypost_replymention

subjectstring | null
textstring
authorstring | null
tostring | null
created_atstring (date-time)
unreadboolean
directionstring

inout

conversation_idstring | null
parent_idstring | null
post_idstring | null
post_titlestring | null
subredditstring | null
permalinkstring (uri) | null
distinguishedstring | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

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

Announcements

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

Try it with MCPAsk your agent to call reddit-announcements-list (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (Reddit after fullname)

limitintegerdefault: 25

1–100

unreadbooleandefault: false

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 7 item attributes
idstring
titlestring | null
bodystring | null
urlstring (uri) | null
sent_atstring (date-time) | null
readboolean
hiddenboolean
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-announcements-read (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/announcements/{itemId}/read
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-announcements-hide (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/announcements/{itemId}/hide
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-announcements-read-all (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/announcements/read-all
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

Moderated subreddits

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

Try it with MCPAsk your agent to call reddit-moderated-subreddits-list (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (Reddit after fullname)

limitintegerdefault: 25

1–100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 22 item attributes
idstring | null

t5_ fullname

namestringrequired
prefixed_namestring
titlestring | null
descriptionstring | null
subscribersinteger | null
active_usersinteger | null
typestring | null

publicprivaterestrictedgold_restrictedarchivedemployees_onlygold_onlyuser

over_18boolean
submission_typestring

anylinkself

post_typesobject
Show 8 child attributes
selfboolean
linkboolean
imageboolean
videoboolean
galleryboolean
videogifboolean
pollboolean
crosspostboolean
spoilers_enabledboolean
link_flair_enabledboolean
restrict_postingboolean
user_is_subscriberboolean
user_is_moderatorboolean
user_is_contributorboolean
user_is_bannedboolean
icon_urlstring (uri) | null
banner_urlstring (uri) | null
urlstring (uri) | null
created_atstring (date-time) | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

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

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

Try it with MCPAsk your agent to call reddit-moderated-subreddits-leave (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/moderated-subreddits/{itemId}/leave
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

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

Try it with MCPAsk your agent to call reddit-moderated-subreddits-leave-contributor (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/moderated-subreddits/{itemId}/leave-contributor
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-moderated-subreddits-accept-invite (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

subredditstringrequired

Subreddit name without r/

≥ 1 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/moderated-subreddits/accept-invite
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

Mod queue

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

Try it with MCPAsk your agent to call reddit-mod-queue-list (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (Reddit after fullname)

limitintegerdefault: 25

1–100

subredditstringdefault: "mod"

Subreddit, or "mod" for all moderated

locationstringdefault: "modqueue"

modqueuereportsspameditedunmoderated

onlystring

linkscomments

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 51 item attributes
idstring

t1_ fullname

short_idstring
titlestring

≤ 300 characters

textstring
urlstring (uri) | null
permalinkstring (uri)
subredditstring
authorstring
created_atstring (date-time)
edited_atstring (date-time) | null
scoreinteger
upvote_rationumber | null

0–1

num_commentsinteger
num_crosspostsinteger
awardsinteger
view_countinteger | null
kindstring

postcomment

domainstring | null
thumbnailstring (uri) | null
flair_textstring | null
flair_template_idstring | null
over_18boolean
spoilerboolean
lockedboolean
stickiedboolean
archivedboolean
distinguishedstring | null
send_repliesboolean | null
savedboolean
hiddenboolean
my_voteinteger

-101

removed_by_categorystring | null
num_reportsinteger
pollobject | null
Show 3 child attributes
total_votesinteger | null
ends_atstring (date-time) | null
optionsarray of object
Show 3 item attributes
idstring
textstring
votesinteger | null
galleryarray of object | null
Show 4 item attributes
media_idstring
captionstring | null
outbound_urlstring (uri) | null
urlstring (uri) | null
video_urlstring (uri) | null
like_countinteger
parent_idstring

t3_ (top level) or t1_ parent

post_idstring
post_titlestring | null
depthinteger
replies_countinteger
is_submitterboolean
is_ownboolean | null
removedboolean
mod_reportsarray of array of string

[[reason, count|moderator]]

user_reportsarray of array of string

[[reason, count|moderator]]

approved_bystring | null
banned_bystring | null
removal_reasonstring | null
ignore_reportsboolean
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-mod-queue-approve (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/mod-queue/{itemId}/approve
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

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

Try it with MCPAsk your agent to call reddit-mod-queue-remove (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

spambooleandefault: false
reason_idstring

Removal reason id

mod_notestring

Private note for the mod log

≤ 100 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/mod-queue/{itemId}/remove
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-mod-queue-send-removal-message (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

messagestringrequired

≥ 1 characters

typestringdefault: "public"

publicprivateprivate_exposed

titlestring

Subject (private messages)

≤ 50 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/mod-queue/{itemId}/send-removal-message
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-mod-queue-distinguish (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

howstringdefault: "yes"

yesnoadminspecial

stickyboolean

Sticky (top-level own comments only)

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/mod-queue/{itemId}/distinguish
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-mod-queue-ignore-reports (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/mod-queue/{itemId}/ignore-reports
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-mod-queue-unignore-reports (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/mod-queue/{itemId}/unignore-reports
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-mod-queue-snooze-reports (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

reasonstringrequired

Report reason to snooze for 7 days

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/mod-queue/{itemId}/snooze-reports
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-mod-queue-unsnooze-reports (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

reasonstringrequired

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/mod-queue/{itemId}/unsnooze-reports
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-mod-queue-lock (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/mod-queue/{itemId}/lock
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-mod-queue-unlock (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/mod-queue/{itemId}/unlock
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-mod-queue-mark-nsfw (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/mod-queue/{itemId}/mark-nsfw
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-mod-queue-unmark-nsfw (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/mod-queue/{itemId}/unmark-nsfw
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-mod-queue-spoiler (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/mod-queue/{itemId}/spoiler
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-mod-queue-unspoiler (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/mod-queue/{itemId}/unspoiler
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-mod-queue-sticky (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

statebooleandefault: true
numinteger

Highlight slot (1–6)

1–6

to_profileboolean

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/mod-queue/{itemId}/sticky
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-mod-queue-contest-mode (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

statebooleandefault: true

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/mod-queue/{itemId}/contest-mode
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-mod-queue-suggested-sort (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

sortstringrequired

confidencetopnewcontroversialoldrandomqaliveblank

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/mod-queue/{itemId}/suggested-sort
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-mod-queue-crowd-control (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

levelintegerrequired

0–3

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/mod-queue/{itemId}/crowd-control
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

Mod log

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

Try it with MCPAsk your agent to call reddit-mod-log-list (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (Reddit after fullname)

limitintegerdefault: 25

1–100

subredditstringdefault: "mod"
typestring

Action type, e.g. removelink, banuser, approvecomment

modstring

Moderator username (comma-separated)

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 12 item attributes
idstring
actionstring
modstring
subredditstring
target_fullnamestring | null
target_authorstring | null
target_titlestring | null
target_bodystring | null
target_permalinkstring (uri) | null
detailsstring | null
descriptionstring | null
created_atstring (date-time)
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

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

Modmail

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

Try it with MCPAsk your agent to call reddit-modmail-list (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (Reddit after fullname)

limitintegerdefault: 25

1–100

statestringdefault: "all"

allappealsnotificationsinboxfilteredinprogressmodarchiveddefaulthighlightedjoin_requestsnew

subredditsstring

Comma-separated subreddits (default: all)

sortstringdefault: "recent"

recentmoduserunread

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 14 item attributes
idstring
subjectstring

≤ 100 characters

subredditstring
stateinteger | null

0 new, 1 in progress, 2 archived, …

is_highlightedboolean
is_internalboolean
is_appealboolean
num_messagesinteger
participantstring | null
authorsarray of string
last_updatedstring (date-time) | null
unreadboolean
last_messagestring | null
messagesarray of object
Show 8 item attributes
idstring
textstring
authorstring
author_is_modboolean
author_hiddenboolean
is_internalboolean
sent_atstring (date-time)
directionstring

inout

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

Responses

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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-modmail-create (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

subredditstringrequired

Subreddit name without r/

≥ 1 characters

tostring

username (omit for a mod discussion)

subjectstringrequired

≤ 100 characters

bodystringrequired

≥ 1 characters

is_author_hiddenbooleandefault: false

Returns object

idstring
subjectstring

≤ 100 characters

subredditstring
stateinteger | null

0 new, 1 in progress, 2 archived, …

is_highlightedboolean
is_internalboolean
is_appealboolean
num_messagesinteger
participantstring | null
authorsarray of string
last_updatedstring (date-time) | null
unreadboolean
last_messagestring | null
messagesarray of object
Show 8 item attributes
idstring
textstring
authorstring
author_is_modboolean
author_hiddenboolean
is_internalboolean
sent_atstring (date-time)
directionstring

inout

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/modmail
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

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

Try it with MCPAsk your agent to call reddit-modmail-get (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Query parameters

mark_readbooleandefault: false

Returns object

idstring
subjectstring

≤ 100 characters

subredditstring
stateinteger | null

0 new, 1 in progress, 2 archived, …

is_highlightedboolean
is_internalboolean
is_appealboolean
num_messagesinteger
participantstring | null
authorsarray of string
last_updatedstring (date-time) | null
unreadboolean
last_messagestring | null
messagesarray of object
Show 8 item attributes
idstring
textstring
authorstring
author_is_modboolean
author_hiddenboolean
is_internalboolean
sent_atstring (date-time)
directionstring

inout

Responses

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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-modmail-reply (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

bodystringrequired

≥ 1 characters

is_internalbooleandefault: false

Private moderator note

is_author_hiddenbooleandefault: false

Reply as the subreddit

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/modmail/{itemId}/reply
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-modmail-archive (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/modmail/{itemId}/archive
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-modmail-unarchive (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/modmail/{itemId}/unarchive
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-modmail-highlight (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/modmail/{itemId}/highlight
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-modmail-unhighlight (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/modmail/{itemId}/unhighlight
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-modmail-read (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/modmail/{itemId}/read
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-modmail-unread (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/modmail/{itemId}/unread
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-modmail-mute (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

num_hoursintegerdefault: 72

72168672

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/modmail/{itemId}/mute
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-modmail-unmute (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/modmail/{itemId}/unmute
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

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

Try it with MCPAsk your agent to call reddit-modmail-temp-ban (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

durationintegerdefault: 7

Days

1–999

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/modmail/{itemId}/temp-ban
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-modmail-unban (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/modmail/{itemId}/unban
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-modmail-approve (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/modmail/{itemId}/approve
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-modmail-disapprove (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/modmail/{itemId}/disapprove
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-modmail-unread-count (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/modmail/unread-count
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

Banned users

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

Try it with MCPAsk your agent to call reddit-banned-users-list (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (Reddit after fullname)

limitintegerdefault: 25

1–100

subredditstring

Subreddit name without r/

≥ 1 characters

userstring

Find one user

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 9 item attributes
idstring

subreddit:username

subredditstring
usernamestring
user_idstring | null
sincestring (date-time) | null
notestring | null
days_leftinteger | null
permissionsarray of string | null
flair_textstring | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-banned-users-create (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

subredditstringrequired

Subreddit name without r/

≥ 1 characters

usernamestringrequired

≥ 1 characters

durationinteger

Days; omit for permanent

1–999

ban_reasonstring

Reason (rule)

≤ 100 characters

notestring

Private mod note

≤ 300 characters

ban_messagestring

Message sent to the user

ban_contextstring

Fullname of the offending post/comment

Returns object

idstring

subreddit:username

subredditstring
usernamestring
user_idstring | null
sincestring (date-time) | null
notestring | null
days_leftinteger | null
permissionsarray of string | null
flair_textstring | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/banned-users
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

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

Try it with MCPAsk your agent to call reddit-banned-users-delete (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

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

Muted users

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

Try it with MCPAsk your agent to call reddit-muted-users-list (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (Reddit after fullname)

limitintegerdefault: 25

1–100

subredditstring

Subreddit name without r/

≥ 1 characters

userstring

Find one user

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 9 item attributes
idstring

subreddit:username

subredditstring
usernamestring
user_idstring | null
sincestring (date-time) | null
notestring | null
days_leftinteger | null
permissionsarray of string | null
flair_textstring | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-muted-users-create (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

subredditstringrequired

Subreddit name without r/

≥ 1 characters

usernamestringrequired

≥ 1 characters

notestring

≤ 300 characters

Returns object

idstring

subreddit:username

subredditstring
usernamestring
user_idstring | null
sincestring (date-time) | null
notestring | null
days_leftinteger | null
permissionsarray of string | null
flair_textstring | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/muted-users
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

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

Try it with MCPAsk your agent to call reddit-muted-users-delete (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

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

Approved users

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

Try it with MCPAsk your agent to call reddit-approved-users-list (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (Reddit after fullname)

limitintegerdefault: 25

1–100

subredditstring

Subreddit name without r/

≥ 1 characters

userstring

Find one user

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 9 item attributes
idstring

subreddit:username

subredditstring
usernamestring
user_idstring | null
sincestring (date-time) | null
notestring | null
days_leftinteger | null
permissionsarray of string | null
flair_textstring | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-approved-users-create (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

subredditstringrequired

Subreddit name without r/

≥ 1 characters

usernamestringrequired

≥ 1 characters

Returns object

idstring

subreddit:username

subredditstring
usernamestring
user_idstring | null
sincestring (date-time) | null
notestring | null
days_leftinteger | null
permissionsarray of string | null
flair_textstring | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/approved-users
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

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

Try it with MCPAsk your agent to call reddit-approved-users-delete (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

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

Wiki banned

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

Try it with MCPAsk your agent to call reddit-wiki-banned-list (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (Reddit after fullname)

limitintegerdefault: 25

1–100

subredditstring

Subreddit name without r/

≥ 1 characters

userstring

Find one user

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 9 item attributes
idstring

subreddit:username

subredditstring
usernamestring
user_idstring | null
sincestring (date-time) | null
notestring | null
days_leftinteger | null
permissionsarray of string | null
flair_textstring | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-wiki-banned-create (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

subredditstringrequired

Subreddit name without r/

≥ 1 characters

usernamestringrequired

≥ 1 characters

durationinteger

1–999

notestring

≤ 300 characters

Returns object

idstring

subreddit:username

subredditstring
usernamestring
user_idstring | null
sincestring (date-time) | null
notestring | null
days_leftinteger | null
permissionsarray of string | null
flair_textstring | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/wiki-banned
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

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

Try it with MCPAsk your agent to call reddit-wiki-banned-delete (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

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

Wiki contributors

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

Try it with MCPAsk your agent to call reddit-wiki-contributors-list (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (Reddit after fullname)

limitintegerdefault: 25

1–100

subredditstring

Subreddit name without r/

≥ 1 characters

userstring

Find one user

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 9 item attributes
idstring

subreddit:username

subredditstring
usernamestring
user_idstring | null
sincestring (date-time) | null
notestring | null
days_leftinteger | null
permissionsarray of string | null
flair_textstring | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-wiki-contributors-create (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

subredditstringrequired

Subreddit name without r/

≥ 1 characters

usernamestringrequired

≥ 1 characters

Returns object

idstring

subreddit:username

subredditstring
usernamestring
user_idstring | null
sincestring (date-time) | null
notestring | null
days_leftinteger | null
permissionsarray of string | null
flair_textstring | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/wiki-contributors
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

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

Try it with MCPAsk your agent to call reddit-wiki-contributors-delete (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

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

Moderators

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

Try it with MCPAsk your agent to call reddit-moderators-list (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

subredditstring

Subreddit name without r/

≥ 1 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 9 item attributes
idstring

subreddit:username

subredditstring
usernamestring
user_idstring | null
sincestring (date-time) | null
notestring | null
days_leftinteger | null
permissionsarray of string | null
flair_textstring | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-moderators-create (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

subredditstringrequired

Subreddit name without r/

≥ 1 characters

usernamestringrequired

≥ 1 characters

permissionsarray of stringdefault: ["all"]

Returns object

idstring

subreddit:username

subredditstring
usernamestring
user_idstring | null
sincestring (date-time) | null
notestring | null
days_leftinteger | null
permissionsarray of string | null
flair_textstring | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/moderators
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

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

Try it with MCPAsk your agent to call reddit-moderators-update (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

permissionsarray of stringrequired
invitebooleandefault: false

Change a pending invite instead

Returns object

idstring

subreddit:username

subredditstring
usernamestring
user_idstring | null
sincestring (date-time) | null
notestring | null
days_leftinteger | null
permissionsarray of string | null
flair_textstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/reddit/moderators/{itemId}
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

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

Try it with MCPAsk your agent to call reddit-moderators-delete (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-moderators-invited (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

subredditstringrequired

Subreddit name without r/

≥ 1 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/moderators/invited
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-moderators-cancel-invite (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/moderators/{itemId}/cancel-invite
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

Mod notes

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

Try it with MCPAsk your agent to call reddit-mod-notes-list (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

subredditstring

Subreddit name without r/

≥ 1 characters

userstring

≥ 1 characters

filterstringdefault: "ALL"

NOTEAPPROVALREMOVALBANMUTEINVITESPAMCONTENT_CHANGEMOD_ACTIONALL

cursorstring
limitintegerdefault: 25

1–100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 12 item attributes
idstring

subreddit:user:note_id

note_idstring
typestring | null
subredditstring
userstring
operatorstring | null
created_atstring (date-time)
notestring | null

≤ 250 characters

labelstring | null

BOT_BANPERMA_BANBANABUSE_WARNINGSPAM_WARNINGSPAM_WATCHSOLID_CONTRIBUTORHELPFUL_USER

reddit_idstring | null
actionstring | null
detailsstring | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-mod-notes-create (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

subredditstringrequired

Subreddit name without r/

≥ 1 characters

userstringrequired
notestringrequired

1–250 characters

labelstring

BOT_BANPERMA_BANBANABUSE_WARNINGSPAM_WARNINGSPAM_WATCHSOLID_CONTRIBUTORHELPFUL_USER

reddit_idstring

Related t3_/t1_ fullname

Returns object

idstring

subreddit:user:note_id

note_idstring
typestring | null
subredditstring
userstring
operatorstring | null
created_atstring (date-time)
notestring | null

≤ 250 characters

labelstring | null

BOT_BANPERMA_BANBANABUSE_WARNINGSPAM_WARNINGSPAM_WATCHSOLID_CONTRIBUTORHELPFUL_USER

reddit_idstring | null
actionstring | null
detailsstring | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/mod-notes
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

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

Try it with MCPAsk your agent to call reddit-mod-notes-delete (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-mod-notes-recent (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

subredditsarray of stringrequired
usersarray of stringrequired

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/mod-notes/recent
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

Removal reasons

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

Try it with MCPAsk your agent to call reddit-removal-reasons-list (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

subredditstring

Subreddit name without r/

≥ 1 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 5 item attributes
idstring

subreddit:reason_id

reason_idstring
subredditstring
titlestring

≤ 50 characters

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

Responses

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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-removal-reasons-create (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

subredditstringrequired

Subreddit name without r/

≥ 1 characters

titlestringrequired

1–50 characters

messagestringrequired

≥ 1 characters

Returns object

idstring

subreddit:reason_id

reason_idstring
subredditstring
titlestring

≤ 50 characters

messagestring

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/removal-reasons
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

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

Try it with MCPAsk your agent to call reddit-removal-reasons-update (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

titlestring

≤ 50 characters

messagestring

Returns object

idstring

subreddit:reason_id

reason_idstring
subredditstring
titlestring

≤ 50 characters

messagestring

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/reddit/removal-reasons/{itemId}
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

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

Try it with MCPAsk your agent to call reddit-removal-reasons-delete (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

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

Flair templates

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

Try it with MCPAsk your agent to call reddit-flair-templates-list (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

subredditstring

Subreddit name without r/

≥ 1 characters

flair_typestringdefault: "LINK_FLAIR"

LINK_FLAIRUSER_FLAIR

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 12 item attributes
idstring

subreddit:template_id

template_idstring
subredditstring
flair_typestring

LINK_FLAIRUSER_FLAIR

textstring

≤ 64 characters

textColorstring | null

lightdark

backgroundColorstring | null
textEditableboolean
modOnlyboolean
allowableContentstring

allemojitext

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

Responses

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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-flair-templates-create (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

subredditstringrequired

Subreddit name without r/

≥ 1 characters

flair_typestringdefault: "LINK_FLAIR"

LINK_FLAIRUSER_FLAIR

textstringrequired

≤ 64 characters

text_colorstring

lightdark

background_colorstring

pattern ^#?[0-9a-fA-F]{6}$|^transparent$

css_classstring
text_editablebooleandefault: false
mod_onlybooleandefault: false
allowable_contentstringdefault: "all"

allemojitext

max_emojisinteger

1–10

Returns object

idstring

subreddit:template_id

template_idstring
subredditstring
flair_typestring

LINK_FLAIRUSER_FLAIR

textstring

≤ 64 characters

textColorstring | null

lightdark

backgroundColorstring | null
textEditableboolean
modOnlyboolean
allowableContentstring

allemojitext

maxEmojisinteger | null
cssClassstring | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/flair-templates
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

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

Try it with MCPAsk your agent to call reddit-flair-templates-update (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

flair_typestringdefault: "LINK_FLAIR"

LINK_FLAIRUSER_FLAIR

textstring

≤ 64 characters

text_colorstring

lightdark

background_colorstring

pattern ^#?[0-9a-fA-F]{6}$|^transparent$

css_classstring
text_editablebooleandefault: false
mod_onlybooleandefault: false
allowable_contentstringdefault: "all"

allemojitext

max_emojisinteger

1–10

Returns object

idstring

subreddit:template_id

template_idstring
subredditstring
flair_typestring

LINK_FLAIRUSER_FLAIR

textstring

≤ 64 characters

textColorstring | null

lightdark

backgroundColorstring | null
textEditableboolean
modOnlyboolean
allowableContentstring

allemojitext

maxEmojisinteger | null
cssClassstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/reddit/flair-templates/{itemId}
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

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

Try it with MCPAsk your agent to call reddit-flair-templates-delete (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-flair-templates-reorder (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

subredditstringrequired

Subreddit name without r/

≥ 1 characters

flair_typestringrequired

LINK_FLAIRUSER_FLAIR

orderarray of stringrequired

template ids

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/flair-templates/reorder
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

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

Try it with MCPAsk your agent to call reddit-flair-templates-clear-all (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

subredditstringrequired

Subreddit name without r/

≥ 1 characters

flair_typestringrequired

LINK_FLAIRUSER_FLAIR

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/flair-templates/clear-all
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-flair-templates-configure (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

subredditstringrequired

Subreddit name without r/

≥ 1 characters

flair_enabledboolean
flair_positionstring

leftright

flair_self_assign_enabledboolean
link_flair_positionstring

leftright

link_flair_self_assign_enabledboolean

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/flair-templates/configure
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

User flairs

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

Try it with MCPAsk your agent to call reddit-user-flairs-list (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (Reddit after fullname)

limitintegerdefault: 25

1–100

subredditstring

Subreddit name without r/

≥ 1 characters

userstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 5 item attributes
idstring

subreddit:username

subredditstring
usernamestring
flair_textstring | null

≤ 64 characters

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

Responses

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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-user-flairs-create (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

subredditstringrequired

Subreddit name without r/

≥ 1 characters

usernamestringrequired

≥ 1 characters

textstring

≤ 64 characters

css_classstring
flair_template_idstring

Returns object

idstring

subreddit:username

subredditstring
usernamestring
flair_textstring | null

≤ 64 characters

flair_css_classstring | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/user-flairs
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

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

Try it with MCPAsk your agent to call reddit-user-flairs-update (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

textstring

≤ 64 characters

css_classstring
flair_template_idstring

Returns object

idstring

subreddit:username

subredditstring
usernamestring
flair_textstring | null

≤ 64 characters

flair_css_classstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/reddit/user-flairs/{itemId}
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

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

Try it with MCPAsk your agent to call reddit-user-flairs-delete (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-user-flairs-bulk-set (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

subredditstringrequired

Subreddit name without r/

≥ 1 characters

csvstringrequired

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/user-flairs/bulk-set
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

Subreddit settings

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

Try it with MCPAsk your agent to call reddit-subreddit-settings-get (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

subredditstring

Subreddit name without r/

≥ 1 characters

Returns object

subredditstring

Subreddit name without r/

≥ 1 characters

titlestring

≤ 100 characters

public_descriptionstring

≤ 500 characters

descriptionstring

Old-reddit sidebar (markdown)

submit_textstring
submit_link_labelstring

≤ 60 characters

submit_text_labelstring

≤ 60 characters

subreddit_typestring

publicprivaterestrictedgold_restrictedarchivedemployees_onlygold_only

content_optionsstring

anylinkself

over_18boolean
allow_imagesboolean
allow_videosboolean
allow_pollsboolean
allow_galleriesboolean
allow_post_crosspostsboolean
spoilers_enabledboolean
original_content_tag_enabledboolean
allow_discoveryboolean
default_setboolean

Allow in r/all & popular

languagestring
welcome_message_enabledboolean
welcome_message_textstring
wikimodestring

disabledmodonlyanyone

wiki_edit_ageinteger
wiki_edit_karmainteger
spam_linksstring

lowhighall

spam_selfpostsstring

lowhighall

spam_commentsstring

lowhighall

exclude_banned_modqueueboolean
collapse_deleted_commentsboolean
comment_score_hide_minsinteger

0–1440

suggested_comment_sortstring | null

confidencetopnewcontroversialoldrandomqalive

show_mediaboolean
show_media_previewboolean
crowd_control_modeboolean
free_form_reportsboolean
key_colorstring
header_hover_textstring

≤ 500 characters

Responses

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

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

Try it with MCPAsk your agent to call reddit-subreddit-settings-update (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

subredditstringrequired

Subreddit name without r/

≥ 1 characters

titlestring

≤ 100 characters

public_descriptionstring

≤ 500 characters

descriptionstring

Old-reddit sidebar (markdown)

submit_textstring
submit_link_labelstring

≤ 60 characters

submit_text_labelstring

≤ 60 characters

subreddit_typestring

publicprivaterestrictedgold_restrictedarchivedemployees_onlygold_only

content_optionsstring

anylinkself

over_18boolean
allow_imagesboolean
allow_videosboolean
allow_pollsboolean
allow_galleriesboolean
allow_post_crosspostsboolean
spoilers_enabledboolean
original_content_tag_enabledboolean
allow_discoveryboolean
default_setboolean

Allow in r/all & popular

languagestring
welcome_message_enabledboolean
welcome_message_textstring
wikimodestring

disabledmodonlyanyone

wiki_edit_ageinteger
wiki_edit_karmainteger
spam_linksstring

lowhighall

spam_selfpostsstring

lowhighall

spam_commentsstring

lowhighall

exclude_banned_modqueueboolean
collapse_deleted_commentsboolean
comment_score_hide_minsinteger

0–1440

suggested_comment_sortstring | null

confidencetopnewcontroversialoldrandomqalive

show_mediaboolean
show_media_previewboolean
crowd_control_modeboolean
free_form_reportsboolean
key_colorstring
header_hover_textstring

≤ 500 characters

Returns object

subredditstring

Subreddit name without r/

≥ 1 characters

titlestring

≤ 100 characters

public_descriptionstring

≤ 500 characters

descriptionstring

Old-reddit sidebar (markdown)

submit_textstring
submit_link_labelstring

≤ 60 characters

submit_text_labelstring

≤ 60 characters

subreddit_typestring

publicprivaterestrictedgold_restrictedarchivedemployees_onlygold_only

content_optionsstring

anylinkself

over_18boolean
allow_imagesboolean
allow_videosboolean
allow_pollsboolean
allow_galleriesboolean
allow_post_crosspostsboolean
spoilers_enabledboolean
original_content_tag_enabledboolean
allow_discoveryboolean
default_setboolean

Allow in r/all & popular

languagestring
welcome_message_enabledboolean
welcome_message_textstring
wikimodestring

disabledmodonlyanyone

wiki_edit_ageinteger
wiki_edit_karmainteger
spam_linksstring

lowhighall

spam_selfpostsstring

lowhighall

spam_commentsstring

lowhighall

exclude_banned_modqueueboolean
collapse_deleted_commentsboolean
comment_score_hide_minsinteger

0–1440

suggested_comment_sortstring | null

confidencetopnewcontroversialoldrandomqalive

show_mediaboolean
show_media_previewboolean
crowd_control_modeboolean
free_form_reportsboolean
key_colorstring
header_hover_textstring

≤ 500 characters

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/reddit/subreddit-settings
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

Stylesheet

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

Try it with MCPAsk your agent to call reddit-stylesheet-get (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

subredditstring

Subreddit name without r/

≥ 1 characters

Returns object

subredditstring
stylesheetstring
imagesarray of object
Show 3 item attributes
namestring
urlstring (uri)
linkstring

Responses

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

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

Try it with MCPAsk your agent to call reddit-stylesheet-update (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

subredditstringrequired

Subreddit name without r/

≥ 1 characters

stylesheetstringrequired
reasonstring

≤ 256 characters

Returns object

subredditstring
stylesheetstring
imagesarray of object
Show 3 item attributes
namestring
urlstring (uri)
linkstring

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/reddit/stylesheet
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

Widgets

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

Try it with MCPAsk your agent to call reddit-widgets-list (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

subredditstring

Subreddit name without r/

≥ 1 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 7 item attributes
idstring

subreddit:widget_id

widget_idstring
subredditstring
sectionstring

sidebartopbaridcardmoderators

kindstring
short_namestring | null
dataobject
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-widgets-create (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

subredditstringrequired

Subreddit name without r/

≥ 1 characters

widgetobjectrequired
Show 2 child attributes
kindstringrequired
shortNamestring

Returns object

idstring

subreddit:widget_id

widget_idstring
subredditstring
sectionstring

sidebartopbaridcardmoderators

kindstring
short_namestring | null
dataobject

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/widgets
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

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

Try it with MCPAsk your agent to call reddit-widgets-update (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

widgetobjectrequired

Returns object

idstring

subreddit:widget_id

widget_idstring
subredditstring
sectionstring

sidebartopbaridcardmoderators

kindstring
short_namestring | null
dataobject

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/reddit/widgets/{itemId}
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

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

Try it with MCPAsk your agent to call reddit-widgets-delete (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-widgets-reorder (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

subredditstringrequired

Subreddit name without r/

≥ 1 characters

sectionstring

sidebar

orderarray of stringrequired

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/widgets/reorder
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

Emojis

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

Try it with MCPAsk your agent to call reddit-emojis-list (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

subredditstring

Subreddit name without r/

≥ 1 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 8 item attributes
idstring

subreddit:name

subredditstring
namestring

pattern ^[A-Za-z0-9_-]{1,24}$

urlstring (uri)
mod_flair_onlyboolean
post_flair_allowedboolean
user_flair_allowedboolean
created_bystring | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call reddit-emojis-create (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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

≤ 255 characters

Body object

subredditstringrequired

Subreddit name without r/

≥ 1 characters

namestringrequired

pattern ^[A-Za-z0-9_-]{1,24}$

imagestringrequired
mod_flair_onlybooleandefault: false
post_flair_allowedbooleandefault: true
user_flair_allowedbooleandefault: true

Returns object

idstring

subreddit:name

subredditstring
namestring

pattern ^[A-Za-z0-9_-]{1,24}$

urlstring (uri)
mod_flair_onlyboolean
post_flair_allowedboolean
user_flair_allowedboolean
created_bystring | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/reddit/emojis
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

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

Try it with MCPAsk your agent to call reddit-emojis-delete (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

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

Traffic

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

Try it with MCPAsk your agent to call reddit-traffic-list (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

subredditstring

Subreddit name without r/

≥ 1 characters

periodstringdefault: "day"

dayhourmonth

sincestring (date)

YYYY-MM-DD

untilstring (date)

YYYY-MM-DD

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 4 item attributes
datestring (date)
uniquesinteger
pageviewsinteger
subscriptionsinteger
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

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

Karma

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

Try it with MCPAsk your agent to call reddit-karma-list (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 4 item attributes
subredditstring
link_karmainteger
comment_karmainteger
totalinteger
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

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

Post performance

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

Try it with MCPAsk your agent to call reddit-post-performance-list (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

sincestring (date)

YYYY-MM-DD

untilstring (date)

YYYY-MM-DD

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 7 item attributes
datestring (date)
likesinteger
commentsinteger
sharesinteger
engagementsinteger
postsinteger
followersinteger | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

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

Subreddit performance

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

Try it with MCPAsk your agent to call reddit-subreddit-performance-list (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

sincestring (date)

YYYY-MM-DD

untilstring (date)

YYYY-MM-DD

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 8 item attributes
subredditstring
postsinteger
total_scoreinteger
avg_scorenumber
avg_upvote_rationumber | null
total_commentsinteger
avg_commentsnumber
removedinteger
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

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

Best times

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

Try it with MCPAsk your agent to call reddit-best-times-list (toolset focus_reddit)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

sincestring (date)

YYYY-MM-DD

untilstring (date)

YYYY-MM-DD

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 6 item attributes
keystring
weekdayinteger

0–6

hourinteger

0–23

postsinteger
avg_scorenumber
avg_commentsnumber
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

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