Skip to content
Docs

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

Base URLhttps://api.socialit.com/v1AuthenticationErrorsRate limits145 endpointsMCP toolset focus_discord

Server

Discord: Get Server overview

GET/accounts/{accountId}/discord/server

Server profile, counts, boost level and settings. Requires scopes: bot. Network docs: https://docs.discord.com/developers/resources/guild Generic route: /v1/accounts/{accountId}/focus/server.

Access: read

Try it with MCPAsk your agent to call discord-server-get (toolset focus_discord)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

idstringread-only
namestring

2–100 characters

descriptionstring | null

≤ 120 characters

icon_urlstring (uri) | nullread-only
iconstring

New icon (image media id / URL / data URI)

bannerstring
splashstring
member_countintegerread-only
online_countintegerread-only
premium_tierintegerread-only
boost_countintegerread-only
featuresarray of stringread-only
verification_levelinteger

01234

default_message_notificationsinteger

0 all messages, 1 only mentions

01

explicit_content_filterinteger

012

preferred_localestring
system_channel_idstring | null
rules_channel_idstring | null
public_updates_channel_idstring | null
safety_alerts_channel_idstring | null
afk_channel_idstring | null
afk_timeoutinteger

6030090018003600

premium_progress_bar_enabledboolean
vanity_url_codestring | nullread-only

Responses

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

Discord: Update Server overview

PATCH/accounts/{accountId}/discord/server

Server profile, counts, boost level and settings. Requires scopes: bot, permission:MANAGE_GUILD. Network docs: https://docs.discord.com/developers/resources/guild Generic route: /v1/accounts/{accountId}/focus/server.

Access: write

Try it with MCPAsk your agent to call discord-server-update (toolset focus_discord)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

idstringread-only
namestring

2–100 characters

descriptionstring | null

≤ 120 characters

icon_urlstring (uri) | nullread-only
iconstring

New icon (image media id / URL / data URI)

bannerstring
splashstring
member_countintegerread-only
online_countintegerread-only
premium_tierintegerread-only
boost_countintegerread-only
featuresarray of stringread-only
verification_levelinteger

01234

default_message_notificationsinteger

0 all messages, 1 only mentions

01

explicit_content_filterinteger

012

preferred_localestring
system_channel_idstring | null
rules_channel_idstring | null
public_updates_channel_idstring | null
safety_alerts_channel_idstring | null
afk_channel_idstring | null
afk_timeoutinteger

6030090018003600

premium_progress_bar_enabledboolean
vanity_url_codestring | nullread-only

Responses

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

Discord: Check bot permissions (Server overview)

POST/accounts/{accountId}/discord/server/refresh-permissions

Effective bot permissions vs. what Socialit core/focus needs. Server profile, counts, boost level and settings. Requires scopes: bot. Network docs: https://docs.discord.com/developers/resources/guild Generic route: /v1/accounts/{accountId}/focus/server.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call discord-server-refresh-permissions (toolset focus_discord)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}/discord/server/refresh-permissions
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/server/refresh-permissions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Discord: Install Socialit commands (Server overview)

POST/accounts/{accountId}/discord/server/register-commands

Registers the "Send to Socialit inbox" message command and /socialit. Server profile, counts, boost level and settings. Requires scopes: bot, applications.commands. Network docs: https://docs.discord.com/developers/resources/guild Generic route: /v1/accounts/{accountId}/focus/server.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call discord-server-register-commands (toolset focus_discord)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}/discord/server/register-commands
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/server/register-commands" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Discord: Pause invites / DMs (raid) (Server overview)

POST/accounts/{accountId}/discord/server/pause-invites

Incident actions, up to 24 h. Server profile, counts, boost level and settings. Requires scopes: bot, permission:MANAGE_GUILD. Network docs: https://docs.discord.com/developers/resources/guild Generic route: /v1/accounts/{accountId}/focus/server.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call discord-server-pause-invites (toolset focus_discord)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

invites_disabled_untilstring (date-time) | null
dms_disabled_untilstring (date-time) | null

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}/discord/server/pause-invites
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/server/pause-invites" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "invites_disabled_until": "2026-10-13T09:00:00.000Z",
    "dms_disabled_until": "2026-10-13T09:00:00.000Z"
  }'
Response · 200

Discord: Remove Socialit bot (Server overview)

POST/accounts/{accountId}/discord/server/leave

The bot leaves the server; every Socialit account bound to it stops working. Server profile, counts, boost level and settings. Destructive. Requires scopes: bot. Network docs: https://docs.discord.com/developers/resources/guild Generic route: /v1/accounts/{accountId}/focus/server.

Access: write

Try it with MCPAsk your agent to call discord-server-leave (toolset focus_discord)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 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}/discord/server/leave
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/server/leave" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Settings

Discord: Get Posting settings

GET/accounts/{accountId}/discord/settings

Default webhook identity and the channel this account posts to. Generic route: /v1/accounts/{accountId}/focus/settings.

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

Try it with MCPAsk your agent to call discord-settings-get (toolset focus_discord)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

modestringread-only

botwebhook

guildIdstringread-only
guildNamestring | nullread-only
channelIdstring

Switch the account to another channel of the same server (bot mode)

channelNamestring | nullread-only
channelTypeinteger | nullread-only
webhookUsernamestring | null

Default display name ("" resets)

≤ 80 characters

webhookAvatarUrlstring (uri) | null

Default avatar ("" resets)

Responses

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

Discord: Update Posting settings

PATCH/accounts/{accountId}/discord/settings

Returns account — the patch the API persists on the social account. Default webhook identity and the channel this account posts to. Generic route: /v1/accounts/{accountId}/focus/settings.

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

Try it with MCPAsk your agent to call discord-settings-update (toolset focus_discord)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

modestringread-only

botwebhook

guildIdstringread-only
guildNamestring | nullread-only
channelIdstring

Switch the account to another channel of the same server (bot mode)

channelNamestring | nullread-only
channelTypeinteger | nullread-only
webhookUsernamestring | null

Default display name ("" resets)

≤ 80 characters

webhookAvatarUrlstring (uri) | null

Default avatar ("" resets)

Responses

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

Welcome screen

Discord: Get Welcome screen

GET/accounts/{accountId}/discord/welcome-screen

Requires scopes: bot, permission:MANAGE_GUILD. Network docs: https://docs.discord.com/developers/resources/guild#welcome-screen-object Generic route: /v1/accounts/{accountId}/focus/welcome-screen.

Access: read

Try it with MCPAsk your agent to call discord-welcome-screen-get (toolset focus_discord)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

enabledboolean
descriptionstring | null

≤ 140 characters

welcome_channelsarray of object

≤ 5 items

Show 4 item attributes
channel_idstring
descriptionstring

≤ 50 characters

emoji_idstring | null
emoji_namestring | null

Responses

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

Discord: Update Welcome screen

PATCH/accounts/{accountId}/discord/welcome-screen

Requires scopes: bot, permission:MANAGE_GUILD. Network docs: https://docs.discord.com/developers/resources/guild#welcome-screen-object Generic route: /v1/accounts/{accountId}/focus/welcome-screen.

Access: write

Try it with MCPAsk your agent to call discord-welcome-screen-update (toolset focus_discord)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

enabledboolean
descriptionstring | null

≤ 140 characters

welcome_channelsarray of object

≤ 5 items

Show 4 item attributes
channel_idstring
descriptionstring

≤ 50 characters

emoji_idstring | null
emoji_namestring | null

Responses

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

Onboarding

Discord: Get Onboarding

GET/accounts/{accountId}/discord/onboarding

Onboarding prompts and default channels (≥7 default channels when enabled). Requires scopes: bot, permission:MANAGE_GUILD, permission:MANAGE_ROLES. Network docs: https://docs.discord.com/developers/resources/guild#guild-onboarding-object Generic route: /v1/accounts/{accountId}/focus/onboarding.

Access: read

Try it with MCPAsk your agent to call discord-onboarding-get (toolset focus_discord)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

enabledboolean
modeinteger

0 default channels only, 1 + questions count toward constraints

01

default_channel_idsarray of string
promptsarray of object
Show 7 item attributes
idstring
typeinteger

0 multiple choice, 1 dropdown

01

titlestring
single_selectboolean
requiredboolean
in_onboardingboolean
optionsarray of object
Show 5 item attributes
idstring
titlestring
descriptionstring | null
channel_idsarray of string
role_idsarray of string

Responses

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

Discord: Update Onboarding

PATCH/accounts/{accountId}/discord/onboarding

Onboarding prompts and default channels (≥7 default channels when enabled). Requires scopes: bot, permission:MANAGE_GUILD, permission:MANAGE_ROLES. Network docs: https://docs.discord.com/developers/resources/guild#guild-onboarding-object Generic route: /v1/accounts/{accountId}/focus/onboarding.

Access: write

Try it with MCPAsk your agent to call discord-onboarding-update (toolset focus_discord)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

enabledboolean
modeinteger

0 default channels only, 1 + questions count toward constraints

01

default_channel_idsarray of string
promptsarray of object
Show 7 item attributes
idstring
typeinteger

0 multiple choice, 1 dropdown

01

titlestring
single_selectboolean
requiredboolean
in_onboardingboolean
optionsarray of object
Show 5 item attributes
idstring
titlestring
descriptionstring | null
channel_idsarray of string
role_idsarray of string

Responses

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

Widget

Discord: Get Server widget

GET/accounts/{accountId}/discord/widget

Requires scopes: bot, permission:MANAGE_GUILD. Network docs: https://docs.discord.com/developers/resources/guild#guild-widget-settings-object Generic route: /v1/accounts/{accountId}/focus/widget.

Access: read

Try it with MCPAsk your agent to call discord-widget-get (toolset focus_discord)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

enabledboolean
channel_idstring | null

Invite channel

widget_json_urlstring (uri)read-only

Responses

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

Discord: Update Server widget

PATCH/accounts/{accountId}/discord/widget

Requires scopes: bot, permission:MANAGE_GUILD. Network docs: https://docs.discord.com/developers/resources/guild#guild-widget-settings-object Generic route: /v1/accounts/{accountId}/focus/widget.

Access: write

Try it with MCPAsk your agent to call discord-widget-update (toolset focus_discord)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

enabledboolean
channel_idstring | null

Invite channel

widget_json_urlstring (uri)read-only

Responses

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

Bot persona

Discord: Get Bot persona

GET/accounts/{accountId}/discord/bot-persona

The Socialit bot's per-server nickname, avatar, banner and bio. Requires scopes: bot. Network docs: https://docs.discord.com/developers/resources/guild#modify-current-member Generic route: /v1/accounts/{accountId}/focus/bot-persona.

Access: read

Try it with MCPAsk your agent to call discord-bot-persona-get (toolset focus_discord)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

nickstring | null

≤ 32 characters

avatarstring | null
bannerstring | null
biostring | null

≤ 190 characters

rolesarray of stringread-only

Responses

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

Discord: Update Bot persona

PATCH/accounts/{accountId}/discord/bot-persona

The Socialit bot's per-server nickname, avatar, banner and bio. Requires scopes: bot. Network docs: https://docs.discord.com/developers/resources/guild#modify-current-member Generic route: /v1/accounts/{accountId}/focus/bot-persona.

Access: write

Try it with MCPAsk your agent to call discord-bot-persona-update (toolset focus_discord)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

nickstring | null

≤ 32 characters

avatarstring | null
bannerstring | null
biostring | null

≤ 190 characters

rolesarray of stringread-only

Responses

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

Integrations

Discord: List Integrations

GET/accounts/{accountId}/discord/integrations

Apps, bots and connected services installed in the server. Cursor pagination: pass next_cursor back as cursor. Requires scopes: bot, permission:MANAGE_GUILD. Network docs: https://docs.discord.com/developers/resources/guild#get-guild-integrations Generic route: /v1/accounts/{accountId}/focus/integrations.

Access: read

Try it with MCPAsk your agent to call discord-integrations-list (toolset focus_discord)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 7 item attributes
idstring
namestring
typestring

twitchyoutubediscordguild_subscription

enabledboolean
application_idstring | null
accountobject
Show 2 child attributes
idstring
namestring
scopesarray of string
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

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

Discord: Delete a Integrations item

DELETE/accounts/{accountId}/discord/integrations/{itemId}

Apps, bots and connected services installed in the server. Requires scopes: bot, permission:MANAGE_GUILD. Network docs: https://docs.discord.com/developers/resources/guild#get-guild-integrations Generic route: /v1/accounts/{accountId}/focus/integrations.

Access: write

Try it with MCPAsk your agent to call discord-integrations-delete (toolset focus_discord)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}/discord/integrations/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/integrations/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Server stats

Discord: Get Server stats

GET/accounts/{accountId}/discord/server-stats

Member and online counts (Discord has no Server Insights API; Socialit snapshots these daily) and members per role. Requires scopes: bot. Generic route: /v1/accounts/{accountId}/focus/server-stats.

Access: read

Try it with MCPAsk your agent to call discord-server-stats-get (toolset focus_discord)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

followersinteger

Approximate members

online_countinteger
boost_countinteger
boost_tierinteger
rolesarray of object
Show 3 item attributes
role_idstring
namestring
membersinteger

Responses

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

Channels

Discord: List Channels

GET/accounts/{accountId}/discord/channels

Text, announcement, forum, media, voice and stage channels and categories. Channels the bot cannot view are hidden by Discord. Cursor pagination: pass next_cursor back as cursor. Requires scopes: bot, permission:VIEW_CHANNEL. Network docs: https://docs.discord.com/developers/resources/channel Generic route: /v1/accounts/{accountId}/focus/channels.

Access: readZernio: GET /v1/accounts/{accountId}/discord-channels

Try it with MCPAsk your agent to call discord-channels-list (toolset focus_discord)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

typesarray of integer

Filter by channel type

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 15 item attributes
idstringread-only
namestringrequired

1–100 characters

typeinteger

0 text, 2 voice, 4 category, 5 announcement, 13 stage, 15 forum, 16 media

0245131516

type_namestringread-only
parent_idstring | null

Category id

positioninteger
topicstring | null

≤ 4096 characters

nsfwboolean
rate_limit_per_userinteger

Slow mode (seconds)

0–21600

bitrateinteger
user_limitinteger
default_auto_archive_durationinteger

601440432010080

available_tagsarray of object

≤ 20 items

Show 4 item attributes
idstring
namestring

≤ 20 characters

moderatedboolean
emoji_namestring | null
permission_overwritesarray of object
Show 4 item attributes
idstring
typeinteger

01

allowstring
denystring
postablebooleanread-only
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}/discord/channels
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/channels" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Discord: Create a Channels item

POST/accounts/{accountId}/discord/channels

Text, announcement, forum, media, voice and stage channels and categories. Channels the bot cannot view are hidden by Discord. Requires scopes: bot, permission:VIEW_CHANNEL, permission:MANAGE_CHANNELS. Network docs: https://docs.discord.com/developers/resources/channel Generic route: /v1/accounts/{accountId}/focus/channels.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call discord-channels-create (toolset focus_discord)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

1–100 characters

typeinteger

0 text, 2 voice, 4 category, 5 announcement, 13 stage, 15 forum, 16 media

0245131516

parent_idstring | null

Category id

positioninteger
topicstring | null

≤ 4096 characters

nsfwboolean
rate_limit_per_userinteger

Slow mode (seconds)

0–21600

bitrateinteger
user_limitinteger
default_auto_archive_durationinteger

601440432010080

available_tagsarray of object

≤ 20 items

Show 4 item attributes
idstring
namestring

≤ 20 characters

moderatedboolean
emoji_namestring | null
permission_overwritesarray of object
Show 4 item attributes
idstring
typeinteger

01

allowstring
denystring

Returns object

idstringread-only
namestringrequired

1–100 characters

typeinteger

0 text, 2 voice, 4 category, 5 announcement, 13 stage, 15 forum, 16 media

0245131516

type_namestringread-only
parent_idstring | null

Category id

positioninteger
topicstring | null

≤ 4096 characters

nsfwboolean
rate_limit_per_userinteger

Slow mode (seconds)

0–21600

bitrateinteger
user_limitinteger
default_auto_archive_durationinteger

601440432010080

available_tagsarray of object

≤ 20 items

Show 4 item attributes
idstring
namestring

≤ 20 characters

moderatedboolean
emoji_namestring | null
permission_overwritesarray of object
Show 4 item attributes
idstring
typeinteger

01

allowstring
denystring
postablebooleanread-only

Responses

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

Discord: Get a Channels item

GET/accounts/{accountId}/discord/channels/{itemId}

Text, announcement, forum, media, voice and stage channels and categories. Channels the bot cannot view are hidden by Discord. Requires scopes: bot, permission:VIEW_CHANNEL. Network docs: https://docs.discord.com/developers/resources/channel Generic route: /v1/accounts/{accountId}/focus/channels.

Access: read

Try it with MCPAsk your agent to call discord-channels-get (toolset focus_discord)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

idstringread-only
namestringrequired

1–100 characters

typeinteger

0 text, 2 voice, 4 category, 5 announcement, 13 stage, 15 forum, 16 media

0245131516

type_namestringread-only
parent_idstring | null

Category id

positioninteger
topicstring | null

≤ 4096 characters

nsfwboolean
rate_limit_per_userinteger

Slow mode (seconds)

0–21600

bitrateinteger
user_limitinteger
default_auto_archive_durationinteger

601440432010080

available_tagsarray of object

≤ 20 items

Show 4 item attributes
idstring
namestring

≤ 20 characters

moderatedboolean
emoji_namestring | null
permission_overwritesarray of object
Show 4 item attributes
idstring
typeinteger

01

allowstring
denystring
postablebooleanread-only

Responses

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

Discord: Update a Channels item

PATCH/accounts/{accountId}/discord/channels/{itemId}

Text, announcement, forum, media, voice and stage channels and categories. Channels the bot cannot view are hidden by Discord. Requires scopes: bot, permission:VIEW_CHANNEL, permission:MANAGE_CHANNELS. Network docs: https://docs.discord.com/developers/resources/channel Generic route: /v1/accounts/{accountId}/focus/channels.

Access: write

Try it with MCPAsk your agent to call discord-channels-update (toolset focus_discord)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

idstringread-only
namestringrequired

1–100 characters

typeinteger

0 text, 2 voice, 4 category, 5 announcement, 13 stage, 15 forum, 16 media

0245131516

type_namestringread-only
parent_idstring | null

Category id

positioninteger
topicstring | null

≤ 4096 characters

nsfwboolean
rate_limit_per_userinteger

Slow mode (seconds)

0–21600

bitrateinteger
user_limitinteger
default_auto_archive_durationinteger

601440432010080

available_tagsarray of object

≤ 20 items

Show 4 item attributes
idstring
namestring

≤ 20 characters

moderatedboolean
emoji_namestring | null
permission_overwritesarray of object
Show 4 item attributes
idstring
typeinteger

01

allowstring
denystring
postablebooleanread-only

Responses

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

Discord: Delete a Channels item

DELETE/accounts/{accountId}/discord/channels/{itemId}

Text, announcement, forum, media, voice and stage channels and categories. Channels the bot cannot view are hidden by Discord. Requires scopes: bot, permission:VIEW_CHANNEL, permission:MANAGE_CHANNELS. Network docs: https://docs.discord.com/developers/resources/channel Generic route: /v1/accounts/{accountId}/focus/channels.

Access: write

Try it with MCPAsk your agent to call discord-channels-delete (toolset focus_discord)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}/discord/channels/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/channels/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Discord: View permissions (Channels)

POST/accounts/{accountId}/discord/channels/{itemId}/view-permissions

Permission overwrites and the Socialit bot's effective permissions in this channel. Text, announcement, forum, media, voice and stage channels and categories. Channels the bot cannot view are hidden by Discord. Requires scopes: bot, permission:VIEW_CHANNEL. Network docs: https://docs.discord.com/developers/resources/channel Generic route: /v1/accounts/{accountId}/focus/channels.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call discord-channels-view-permissions (toolset focus_discord)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}/discord/channels/{itemId}/view-permissions
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/channels/ITEM_ID/view-permissions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Discord: Set permission overwrite (Channels)

POST/accounts/{accountId}/discord/channels/{itemId}/set-permission

Set permission overwrite. Text, announcement, forum, media, voice and stage channels and categories. Channels the bot cannot view are hidden by Discord. Requires scopes: bot, permission:VIEW_CHANNEL, permission:MANAGE_ROLES. Network docs: https://docs.discord.com/developers/resources/channel Generic route: /v1/accounts/{accountId}/focus/channels.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call discord-channels-set-permission (toolset focus_discord)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

overwrite_idstringrequired

Role or member id

typestringrequired

rolemember

allowarray of string

Permission flag names

denyarray of string
reasonstring

Shown in the server audit log

≤ 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}/discord/channels/{itemId}/set-permission
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/channels/ITEM_ID/set-permission" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "overwrite_id": "string",
    "type": "role",
    "allow": [
      "string"
    ],
    "deny": [
      "string"
    ],
    "reason": "string"
  }'
Response · 200

Discord: Remove permission overwrite (Channels)

POST/accounts/{accountId}/discord/channels/{itemId}/delete-permission

Remove permission overwrite. Text, announcement, forum, media, voice and stage channels and categories. Channels the bot cannot view are hidden by Discord. Destructive. Requires scopes: bot, permission:VIEW_CHANNEL, permission:MANAGE_ROLES. Network docs: https://docs.discord.com/developers/resources/channel Generic route: /v1/accounts/{accountId}/focus/channels.

Access: write

Try it with MCPAsk your agent to call discord-channels-delete-permission (toolset focus_discord)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

overwrite_idstringrequired
reasonstring

Shown in the server audit log

≤ 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}/discord/channels/{itemId}/delete-permission
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/channels/ITEM_ID/delete-permission" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "overwrite_id": "string",
    "reason": "string"
  }'
Response · 200

Discord: Reorder channels (Channels)

POST/accounts/{accountId}/discord/channels/reorder

One parent_id change per request (Discord rule). Text, announcement, forum, media, voice and stage channels and categories. Channels the bot cannot view are hidden by Discord. Requires scopes: bot, permission:VIEW_CHANNEL, permission:MANAGE_CHANNELS. Network docs: https://docs.discord.com/developers/resources/channel Generic route: /v1/accounts/{accountId}/focus/channels.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call discord-channels-reorder (toolset focus_discord)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

positionsarray of object

≥ 1 items

Show 4 item attributes
idstring
positioninteger
parent_idstring | null
lock_permissionsboolean

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}/discord/channels/reorder
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/channels/reorder" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "positions": [
      {
        "id": "string",
        "position": 1
      }
    ]
  }'
Response · 200

Discord: Follow announcements into a channel (Channels)

POST/accounts/{accountId}/discord/channels/{itemId}/follow

Cross-server syndication of an announcement channel. Text, announcement, forum, media, voice and stage channels and categories. Channels the bot cannot view are hidden by Discord. Requires scopes: bot, permission:VIEW_CHANNEL, permission:MANAGE_WEBHOOKS. Network docs: https://docs.discord.com/developers/resources/channel Generic route: /v1/accounts/{accountId}/focus/channels.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call discord-channels-follow (toolset focus_discord)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

webhook_channel_idstringrequired

Target channel (in a server Socialit manages)

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}/discord/channels/{itemId}/follow
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/channels/ITEM_ID/follow" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "webhook_channel_id": "string"
  }'
Response · 200

Discord: Create invite (Channels)

POST/accounts/{accountId}/discord/channels/{itemId}/create-invite

Create invite. Text, announcement, forum, media, voice and stage channels and categories. Channels the bot cannot view are hidden by Discord. Requires scopes: bot, permission:VIEW_CHANNEL, permission:CREATE_INSTANT_INVITE. Network docs: https://docs.discord.com/developers/resources/channel Generic route: /v1/accounts/{accountId}/focus/channels.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call discord-channels-create-invite (toolset focus_discord)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

max_ageintegerdefault: 86400

0–604800

max_usesinteger

0–100

temporaryboolean
uniqueboolean

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}/discord/channels/{itemId}/create-invite
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/channels/ITEM_ID/create-invite" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "max_age": 86400,
    "max_uses": 0,
    "temporary": true,
    "unique": true
  }'
Response · 200

Threads

Discord: List Threads

GET/accounts/{accountId}/discord/threads

Active and archived threads; create from a message or standalone, archive, lock, manage members. Cursor pagination: pass next_cursor back as cursor. Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY. Network docs: https://docs.discord.com/developers/topics/threads Generic route: /v1/accounts/{accountId}/focus/threads.

Access: read

Try it with MCPAsk your agent to call discord-threads-list (toolset focus_discord)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

channel_idstring

Parent channel filter

archivedboolean

List archived threads of channel_id

privateboolean
beforestring (date-time)
limitinteger

1–100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 15 item attributes
idstringread-only
namestringrequired

1–100 characters

parent_idstring

Parent channel

typeinteger

10 announcement, 11 public, 12 private

101112

message_idstring | null

Start from this message (create)

archivedboolean
lockedboolean
invitableboolean
auto_archive_durationinteger

601440432010080

rate_limit_per_userinteger

0–21600

applied_tagsarray of string

≤ 5 items

message_countintegerread-only
member_countintegerread-only
owner_idstring | nullread-only
created_atstring (date-time) | nullread-only
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}/discord/threads
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/threads" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Discord: Create a Threads item

POST/accounts/{accountId}/discord/threads

Active and archived threads; create from a message or standalone, archive, lock, manage members. Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY, permission:CREATE_PUBLIC_THREADS. Network docs: https://docs.discord.com/developers/topics/threads Generic route: /v1/accounts/{accountId}/focus/threads.

Access: writeIdempotency-KeyZernio: POST /v1/discord/channels/{channelId}/threads

Try it with MCPAsk your agent to call discord-threads-create (toolset focus_discord)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

1–100 characters

parent_idstring

Parent channel

typeinteger

10 announcement, 11 public, 12 private

101112

message_idstring | null

Start from this message (create)

archivedboolean
lockedboolean
invitableboolean
auto_archive_durationinteger

601440432010080

rate_limit_per_userinteger

0–21600

applied_tagsarray of string

≤ 5 items

Returns object

idstringread-only
namestringrequired

1–100 characters

parent_idstring

Parent channel

typeinteger

10 announcement, 11 public, 12 private

101112

message_idstring | null

Start from this message (create)

archivedboolean
lockedboolean
invitableboolean
auto_archive_durationinteger

601440432010080

rate_limit_per_userinteger

0–21600

applied_tagsarray of string

≤ 5 items

message_countintegerread-only
member_countintegerread-only
owner_idstring | nullread-only
created_atstring (date-time) | nullread-only

Responses

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

Discord: Get a Threads item

GET/accounts/{accountId}/discord/threads/{itemId}

Active and archived threads; create from a message or standalone, archive, lock, manage members. Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY. Network docs: https://docs.discord.com/developers/topics/threads Generic route: /v1/accounts/{accountId}/focus/threads.

Access: read

Try it with MCPAsk your agent to call discord-threads-get (toolset focus_discord)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

idstringread-only
namestringrequired

1–100 characters

parent_idstring

Parent channel

typeinteger

10 announcement, 11 public, 12 private

101112

message_idstring | null

Start from this message (create)

archivedboolean
lockedboolean
invitableboolean
auto_archive_durationinteger

601440432010080

rate_limit_per_userinteger

0–21600

applied_tagsarray of string

≤ 5 items

message_countintegerread-only
member_countintegerread-only
owner_idstring | nullread-only
created_atstring (date-time) | nullread-only

Responses

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

Discord: Update a Threads item

PATCH/accounts/{accountId}/discord/threads/{itemId}

Active and archived threads; create from a message or standalone, archive, lock, manage members. Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY, permission:MANAGE_THREADS. Network docs: https://docs.discord.com/developers/topics/threads Generic route: /v1/accounts/{accountId}/focus/threads.

Access: write

Try it with MCPAsk your agent to call discord-threads-update (toolset focus_discord)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

idstringread-only
namestringrequired

1–100 characters

parent_idstring

Parent channel

typeinteger

10 announcement, 11 public, 12 private

101112

message_idstring | null

Start from this message (create)

archivedboolean
lockedboolean
invitableboolean
auto_archive_durationinteger

601440432010080

rate_limit_per_userinteger

0–21600

applied_tagsarray of string

≤ 5 items

message_countintegerread-only
member_countintegerread-only
owner_idstring | nullread-only
created_atstring (date-time) | nullread-only

Responses

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

Discord: Delete a Threads item

DELETE/accounts/{accountId}/discord/threads/{itemId}

Active and archived threads; create from a message or standalone, archive, lock, manage members. Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY, permission:MANAGE_THREADS. Network docs: https://docs.discord.com/developers/topics/threads Generic route: /v1/accounts/{accountId}/focus/threads.

Access: write

Try it with MCPAsk your agent to call discord-threads-delete (toolset focus_discord)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}/discord/threads/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/threads/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Discord: Join thread (Threads)

POST/accounts/{accountId}/discord/threads/{itemId}/join

Join thread. Active and archived threads; create from a message or standalone, archive, lock, manage members. Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY. Network docs: https://docs.discord.com/developers/topics/threads Generic route: /v1/accounts/{accountId}/focus/threads.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call discord-threads-join (toolset focus_discord)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}/discord/threads/{itemId}/join
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/threads/ITEM_ID/join" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Discord: Leave thread (Threads)

POST/accounts/{accountId}/discord/threads/{itemId}/leave

Leave thread. Active and archived threads; create from a message or standalone, archive, lock, manage members. Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY. Network docs: https://docs.discord.com/developers/topics/threads Generic route: /v1/accounts/{accountId}/focus/threads.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call discord-threads-leave (toolset focus_discord)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}/discord/threads/{itemId}/leave
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/threads/ITEM_ID/leave" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Discord: Add member (Threads)

POST/accounts/{accountId}/discord/threads/{itemId}/add-member

Add member. Active and archived threads; create from a message or standalone, archive, lock, manage members. Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY. Network docs: https://docs.discord.com/developers/topics/threads Generic route: /v1/accounts/{accountId}/focus/threads.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call discord-threads-add-member (toolset focus_discord)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

user_idstringrequired

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}/discord/threads/{itemId}/add-member
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/threads/ITEM_ID/add-member" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "string"
  }'
Response · 200

Discord: Remove member (Threads)

POST/accounts/{accountId}/discord/threads/{itemId}/remove-member

Remove member. Active and archived threads; create from a message or standalone, archive, lock, manage members. Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY, permission:MANAGE_THREADS. Network docs: https://docs.discord.com/developers/topics/threads Generic route: /v1/accounts/{accountId}/focus/threads.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call discord-threads-remove-member (toolset focus_discord)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

user_idstringrequired

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}/discord/threads/{itemId}/remove-member
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/threads/ITEM_ID/remove-member" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "string"
  }'
Response · 200

Discord: List members (Threads)

POST/accounts/{accountId}/discord/threads/{itemId}/members

Needs the privileged GUILD_MEMBERS intent. Active and archived threads; create from a message or standalone, archive, lock, manage members. Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY, intent:GUILD_MEMBERS. Network docs: https://docs.discord.com/developers/topics/threads Generic route: /v1/accounts/{accountId}/focus/threads.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call discord-threads-members (toolset focus_discord)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}/discord/threads/{itemId}/members
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/threads/ITEM_ID/members" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Forum posts

Discord: List Forum posts

GET/accounts/{accountId}/discord/forum-posts

Posts in forum and media channels: create with tags, archive, lock, pin. Cursor pagination: pass next_cursor back as cursor. Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY. Network docs: https://docs.discord.com/developers/topics/threads#forums Generic route: /v1/accounts/{accountId}/focus/forum-posts.

Access: read

Try it with MCPAsk your agent to call discord-forum-posts-list (toolset focus_discord)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

forum_idstring
archivedboolean
beforestring (date-time)
limitinteger

1–100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 12 item attributes
idstringread-only

Thread id (= starter message id)

forum_idstring

Forum or media channel (default: the account channel)

titlestringrequired

1–100 characters

contentstring

Starter message (create)

≤ 2000 characters

mediaarray of string

≤ 10 items

applied_tagsarray of string

≤ 5 items

archivedboolean
lockedboolean
pinnedboolean
message_countintegerread-only
created_atstring (date-time) | nullread-only
external_idstringread-only

Socialit post id (thread:message)

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}/discord/forum-posts
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/forum-posts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Discord: Create a Forum posts item

POST/accounts/{accountId}/discord/forum-posts

Posts in forum and media channels: create with tags, archive, lock, pin. Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY, permission:SEND_MESSAGES. Network docs: https://docs.discord.com/developers/topics/threads#forums Generic route: /v1/accounts/{accountId}/focus/forum-posts.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call discord-forum-posts-create (toolset focus_discord)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

forum_idstring

Forum or media channel (default: the account channel)

titlestringrequired

1–100 characters

contentstring

Starter message (create)

≤ 2000 characters

mediaarray of string

≤ 10 items

applied_tagsarray of string

≤ 5 items

archivedboolean
lockedboolean
pinnedboolean

Returns object

idstringread-only

Thread id (= starter message id)

forum_idstring

Forum or media channel (default: the account channel)

titlestringrequired

1–100 characters

contentstring

Starter message (create)

≤ 2000 characters

mediaarray of string

≤ 10 items

applied_tagsarray of string

≤ 5 items

archivedboolean
lockedboolean
pinnedboolean
message_countintegerread-only
created_atstring (date-time) | nullread-only
external_idstringread-only

Socialit post id (thread:message)

Responses

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

Discord: Get a Forum posts item

GET/accounts/{accountId}/discord/forum-posts/{itemId}

Posts in forum and media channels: create with tags, archive, lock, pin. Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY. Network docs: https://docs.discord.com/developers/topics/threads#forums Generic route: /v1/accounts/{accountId}/focus/forum-posts.

Access: read

Try it with MCPAsk your agent to call discord-forum-posts-get (toolset focus_discord)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

idstringread-only

Thread id (= starter message id)

forum_idstring

Forum or media channel (default: the account channel)

titlestringrequired

1–100 characters

contentstring

Starter message (create)

≤ 2000 characters

mediaarray of string

≤ 10 items

applied_tagsarray of string

≤ 5 items

archivedboolean
lockedboolean
pinnedboolean
message_countintegerread-only
created_atstring (date-time) | nullread-only
external_idstringread-only

Socialit post id (thread:message)

Responses

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

Discord: Update a Forum posts item

PATCH/accounts/{accountId}/discord/forum-posts/{itemId}

Posts in forum and media channels: create with tags, archive, lock, pin. Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY, permission:MANAGE_THREADS. Network docs: https://docs.discord.com/developers/topics/threads#forums Generic route: /v1/accounts/{accountId}/focus/forum-posts.

Access: write

Try it with MCPAsk your agent to call discord-forum-posts-update (toolset focus_discord)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

idstringread-only

Thread id (= starter message id)

forum_idstring

Forum or media channel (default: the account channel)

titlestringrequired

1–100 characters

contentstring

Starter message (create)

≤ 2000 characters

mediaarray of string

≤ 10 items

applied_tagsarray of string

≤ 5 items

archivedboolean
lockedboolean
pinnedboolean
message_countintegerread-only
created_atstring (date-time) | nullread-only
external_idstringread-only

Socialit post id (thread:message)

Responses

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

Discord: Delete a Forum posts item

DELETE/accounts/{accountId}/discord/forum-posts/{itemId}

Posts in forum and media channels: create with tags, archive, lock, pin. Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY, permission:MANAGE_THREADS. Network docs: https://docs.discord.com/developers/topics/threads#forums Generic route: /v1/accounts/{accountId}/focus/forum-posts.

Access: write

Try it with MCPAsk your agent to call discord-forum-posts-delete (toolset focus_discord)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}/discord/forum-posts/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/forum-posts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Discord: Edit forum tags (Forum posts)

POST/accounts/{accountId}/discord/forum-posts/set-tags

Edit forum tags. Posts in forum and media channels: create with tags, archive, lock, pin. Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY, permission:MANAGE_CHANNELS. Network docs: https://docs.discord.com/developers/topics/threads#forums Generic route: /v1/accounts/{accountId}/focus/forum-posts.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call discord-forum-posts-set-tags (toolset focus_discord)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

forum_idstring
available_tagsarray of object

≤ 20 items

Show 5 item attributes
idstring | null
namestring

≤ 20 characters

moderatedboolean
emoji_namestring | null
emoji_idstring | null

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}/discord/forum-posts/set-tags
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/forum-posts/set-tags" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "forum_id": "string",
    "available_tags": [
      {
        "id": "string",
        "name": "string"
      }
    ]
  }'
Response · 200

Webhooks

Discord: List Webhooks

GET/accounts/{accountId}/discord/webhooks

Channel webhooks (≤15 per channel, ≤1000 per server). Tokens are never shown. Cursor pagination: pass next_cursor back as cursor. Requires scopes: bot, permission:MANAGE_WEBHOOKS. Network docs: https://docs.discord.com/developers/resources/webhook Generic route: /v1/accounts/{accountId}/focus/webhooks.

Access: read

Try it with MCPAsk your agent to call discord-webhooks-list (toolset focus_discord)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

channel_idstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 8 item attributes
idstringread-only
namestringrequired

1–80 characters

channel_idstringrequired
avatarstring | null

Avatar image (write)

typeintegerread-only

1 incoming, 2 channel follower, 3 application

application_idstring | nullread-only
owned_by_socialitbooleanread-only
creatorstring | nullread-only
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}/discord/webhooks
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/webhooks" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Discord: Create a Webhooks item

POST/accounts/{accountId}/discord/webhooks

Channel webhooks (≤15 per channel, ≤1000 per server). Tokens are never shown. Requires scopes: bot, permission:MANAGE_WEBHOOKS. Network docs: https://docs.discord.com/developers/resources/webhook Generic route: /v1/accounts/{accountId}/focus/webhooks.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call discord-webhooks-create (toolset focus_discord)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

1–80 characters

channel_idstringrequired
avatarstring | null

Avatar image (write)

Returns object

idstringread-only
namestringrequired

1–80 characters

channel_idstringrequired
avatarstring | null

Avatar image (write)

typeintegerread-only

1 incoming, 2 channel follower, 3 application

application_idstring | nullread-only
owned_by_socialitbooleanread-only
creatorstring | nullread-only

Responses

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

Discord: Get a Webhooks item

GET/accounts/{accountId}/discord/webhooks/{itemId}

Channel webhooks (≤15 per channel, ≤1000 per server). Tokens are never shown. Requires scopes: bot, permission:MANAGE_WEBHOOKS. Network docs: https://docs.discord.com/developers/resources/webhook Generic route: /v1/accounts/{accountId}/focus/webhooks.

Access: read

Try it with MCPAsk your agent to call discord-webhooks-get (toolset focus_discord)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

idstringread-only
namestringrequired

1–80 characters

channel_idstringrequired
avatarstring | null

Avatar image (write)

typeintegerread-only

1 incoming, 2 channel follower, 3 application

application_idstring | nullread-only
owned_by_socialitbooleanread-only
creatorstring | nullread-only

Responses

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

Discord: Update a Webhooks item

PATCH/accounts/{accountId}/discord/webhooks/{itemId}

Channel webhooks (≤15 per channel, ≤1000 per server). Tokens are never shown. Requires scopes: bot, permission:MANAGE_WEBHOOKS. Network docs: https://docs.discord.com/developers/resources/webhook Generic route: /v1/accounts/{accountId}/focus/webhooks.

Access: write

Try it with MCPAsk your agent to call discord-webhooks-update (toolset focus_discord)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

idstringread-only
namestringrequired

1–80 characters

channel_idstringrequired
avatarstring | null

Avatar image (write)

typeintegerread-only

1 incoming, 2 channel follower, 3 application

application_idstring | nullread-only
owned_by_socialitbooleanread-only
creatorstring | nullread-only

Responses

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

Discord: Delete a Webhooks item

DELETE/accounts/{accountId}/discord/webhooks/{itemId}

Channel webhooks (≤15 per channel, ≤1000 per server). Tokens are never shown. Requires scopes: bot, permission:MANAGE_WEBHOOKS. Network docs: https://docs.discord.com/developers/resources/webhook Generic route: /v1/accounts/{accountId}/focus/webhooks.

Access: write

Try it with MCPAsk your agent to call discord-webhooks-delete (toolset focus_discord)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}/discord/webhooks/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/webhooks/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Discord: Send test message (Webhooks)

POST/accounts/{accountId}/discord/webhooks/{itemId}/send

Send test message. Channel webhooks (≤15 per channel, ≤1000 per server). Tokens are never shown. Requires scopes: bot, permission:MANAGE_WEBHOOKS. Network docs: https://docs.discord.com/developers/resources/webhook Generic route: /v1/accounts/{accountId}/focus/webhooks.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call discord-webhooks-send (toolset focus_discord)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

contentstringrequired

≤ 2000 characters

usernamestring

≤ 80 characters

avatar_urlstring (uri)

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}/discord/webhooks/{itemId}/send
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/webhooks/ITEM_ID/send" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "string",
    "username": "string",
    "avatar_url": "https://example.com"
  }'
Response · 200

Stage instances

Discord: List Stage instances

GET/accounts/{accountId}/discord/stage-instances

Live Stage sessions (topic, start notification, linked event). Cursor pagination: pass next_cursor back as cursor. Requires scopes: bot, permission:MANAGE_CHANNELS, permission:MUTE_MEMBERS, permission:MOVE_MEMBERS. Network docs: https://docs.discord.com/developers/resources/stage-instance Generic route: /v1/accounts/{accountId}/focus/stage-instances.

Access: read

Try it with MCPAsk your agent to call discord-stage-instances-list (toolset focus_discord)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 6 item attributes
idstringread-only
channel_idstringrequired
topicstringrequired

1–120 characters

privacy_levelintegerread-only

2

send_start_notificationboolean

Notify @everyone (MENTION_EVERYONE)

guild_scheduled_event_idstring | 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}/discord/stage-instances
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/stage-instances" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Discord: Create a Stage instances item

POST/accounts/{accountId}/discord/stage-instances

Live Stage sessions (topic, start notification, linked event). Requires scopes: bot, permission:MANAGE_CHANNELS, permission:MUTE_MEMBERS, permission:MOVE_MEMBERS. Network docs: https://docs.discord.com/developers/resources/stage-instance Generic route: /v1/accounts/{accountId}/focus/stage-instances.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call discord-stage-instances-create (toolset focus_discord)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

channel_idstringrequired
topicstringrequired

1–120 characters

send_start_notificationboolean

Notify @everyone (MENTION_EVERYONE)

guild_scheduled_event_idstring | null

Returns object

idstringread-only
channel_idstringrequired
topicstringrequired

1–120 characters

privacy_levelintegerread-only

2

send_start_notificationboolean

Notify @everyone (MENTION_EVERYONE)

guild_scheduled_event_idstring | null

Responses

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

Discord: Get a Stage instances item

GET/accounts/{accountId}/discord/stage-instances/{itemId}

Live Stage sessions (topic, start notification, linked event). Requires scopes: bot, permission:MANAGE_CHANNELS, permission:MUTE_MEMBERS, permission:MOVE_MEMBERS. Network docs: https://docs.discord.com/developers/resources/stage-instance Generic route: /v1/accounts/{accountId}/focus/stage-instances.

Access: read

Try it with MCPAsk your agent to call discord-stage-instances-get (toolset focus_discord)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

idstringread-only
channel_idstringrequired
topicstringrequired

1–120 characters

privacy_levelintegerread-only

2

send_start_notificationboolean

Notify @everyone (MENTION_EVERYONE)

guild_scheduled_event_idstring | null

Responses

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

Discord: Update a Stage instances item

PATCH/accounts/{accountId}/discord/stage-instances/{itemId}

Live Stage sessions (topic, start notification, linked event). Requires scopes: bot, permission:MANAGE_CHANNELS, permission:MUTE_MEMBERS, permission:MOVE_MEMBERS. Network docs: https://docs.discord.com/developers/resources/stage-instance Generic route: /v1/accounts/{accountId}/focus/stage-instances.

Access: write

Try it with MCPAsk your agent to call discord-stage-instances-update (toolset focus_discord)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

idstringread-only
channel_idstringrequired
topicstringrequired

1–120 characters

privacy_levelintegerread-only

2

send_start_notificationboolean

Notify @everyone (MENTION_EVERYONE)

guild_scheduled_event_idstring | null

Responses

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

Discord: Delete a Stage instances item

DELETE/accounts/{accountId}/discord/stage-instances/{itemId}

Live Stage sessions (topic, start notification, linked event). Requires scopes: bot, permission:MANAGE_CHANNELS, permission:MUTE_MEMBERS, permission:MOVE_MEMBERS. Network docs: https://docs.discord.com/developers/resources/stage-instance Generic route: /v1/accounts/{accountId}/focus/stage-instances.

Access: write

Try it with MCPAsk your agent to call discord-stage-instances-delete (toolset focus_discord)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}/discord/stage-instances/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/stage-instances/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Messages

Discord: List Messages

GET/accounts/{accountId}/discord/messages

Channel and thread history. Without the MESSAGE_CONTENT intent Discord withholds other users' message content (content_restricted). Cursor pagination: pass next_cursor back as cursor. Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY. Network docs: https://docs.discord.com/developers/resources/message Generic route: /v1/accounts/{accountId}/focus/messages.

Access: read

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

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

channel_idstring

Channel or thread (default: the account channel)

beforestring
afterstring
aroundstring
limitintegerdefault: 50

1–100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 16 item attributes
idstringread-only

channelId:messageId

message_idstringread-only
channel_idstring
textstring | null

≤ 2000 characters

authorstring | nullread-only
author_idstring | nullread-only
author_avatar_urlstring (uri) | nullread-only
created_atstring (date-time)read-only
edited_atstring (date-time) | nullread-only
like_countintegerread-only
reactionsarray of objectread-only
Show 3 item attributes
emojistring
countinteger
meboolean
reply_to_idstring | nullread-only
attachmentsarray of objectread-only
Show 4 item attributes
idstring
urlstring (uri)
filenamestring
content_typestring | null
embedsarray of objectread-only
content_restrictedbooleanread-only

Content withheld by Discord (MESSAGE_CONTENT intent missing)

urlstring (uri)read-only
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}/discord/messages
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/messages" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Discord: Create a Messages item

POST/accounts/{accountId}/discord/messages

Send now (same engine as publishing). Channel and thread history. Without the MESSAGE_CONTENT intent Discord withholds other users' message content (content_restricted). Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY, permission:SEND_MESSAGES. Network docs: https://docs.discord.com/developers/resources/message Generic route: /v1/accounts/{accountId}/focus/messages.

Access: writeIdempotency-KeyZernio: POST /v1/discord/channels/{channelId}/messages/{messageId}/crosspost

Try it with MCPAsk your agent to call discord-messages-create (toolset focus_discord)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

channel_idstring

Default: the account channel

textstring

≤ 2000 characters

mediaarray of string

≤ 10 items

reply_to_idstring

channel:message to reply to

optionsobject

Same options as platform_options.discord

Show 23 child attributes
channelIdstring

Target channel snowflake (default: the account channel). Must be in the connected server.

threadIdstring

Post into an existing thread / forum post instead of the channel.

embedsarray of object

Rich embeds; ≤6,000 chars combined.

≤ 10 items

Show 10 item attributes
titlestring

≤ 256 characters

descriptionstring

≤ 4096 characters

urlstring (uri)
colorinteger | string

Decimal or #RRGGBB

timestampstring (date-time)
imageobject
Show 1 child attributes
urlstring
thumbnailobject
Show 1 child attributes
urlstring
footerobject
Show 2 child attributes
textstring

≤ 2048 characters

icon_urlstring
authorobject
Show 3 child attributes
namestring

≤ 256 characters

urlstring
icon_urlstring
fieldsarray of object

≤ 25 items

Show 3 item attributes
namestringrequired

≤ 256 characters

valuestringrequired

≤ 1024 characters

inlineboolean
pollobject

Native poll (cannot be edited; no attachments). Discord shape or { question: string, options: string[], durationHours, multiselect }.

Show 7 child attributes
questionstring | object
One of 2 shapes

Option 1 string

Option 2 object

textstring

≤ 300 characters

answersarray of any

1–10 items

optionsarray of string

1–10 items

durationintegerdefault: 24

1–768

durationHoursinteger

1–768

allow_multiselectbooleandefault: false
multiselectboolean
crosspostbooleandefault: false

Publish to followers when the channel is an announcement channel (10/hour/channel).

forumThreadNamestring

Forum/media post title (required for forum channels; defaults to the first line).

≤ 100 characters

forumAppliedTagsarray of string

Forum tag ids.

≤ 5 items

autoArchiveDurationinteger

Forum post auto-archive (minutes).

601440432010080

rateLimitPerUserinteger

Forum post slow mode (seconds).

0–21600

threadFromMessageobject

Open a public thread under the published message.

Show 3 child attributes
namestring

1–100 characters

autoArchiveDurationinteger

601440432010080

rateLimitPerUserinteger

0–21600

ttsbooleandefault: false
silentbooleandefault: false

SUPPRESS_NOTIFICATIONS flag.

suppressEmbedsbooleandefault: false

Hide link previews.

mentionsstringdefault: "none"

Which mentions in the content ping (default none; "everyone" needs MENTION_EVERYONE).

noneusersroleseveryone

allowedMentionsobject

Raw Discord allowed_mentions (overrides mentions).

buttonsarray of object

Link buttons (rendered as action rows of up to 5).

≤ 25 items

Show 3 item attributes
labelstringrequired

≤ 80 characters

urlstring (uri)required
emojistring
componentsarray of any

Raw message components (action rows or Components V2 layout).

componentsV2boolean

Send components as a Components V2 layout (IS_COMPONENTS_V2; content/embeds/poll disabled; irreversible).

stickerIdsarray of string

≤ 3 items

pinboolean

Pin the message after publishing (PIN_MESSAGES).

webhookUsernamestring

Per-post display name (may not contain "clyde"/"discord").

1–80 characters

webhookAvatarUrlstring (uri)

Per-post avatar URL.

noncestring

Idempotency nonce (enforce_nonce).

≤ 25 characters

Returns object

idstringread-only

channelId:messageId

message_idstringread-only
channel_idstring
textstring | null

≤ 2000 characters

authorstring | nullread-only
author_idstring | nullread-only
author_avatar_urlstring (uri) | nullread-only
created_atstring (date-time)read-only
edited_atstring (date-time) | nullread-only
like_countintegerread-only
reactionsarray of objectread-only
Show 3 item attributes
emojistring
countinteger
meboolean
reply_to_idstring | nullread-only
attachmentsarray of objectread-only
Show 4 item attributes
idstring
urlstring (uri)
filenamestring
content_typestring | null
embedsarray of objectread-only
content_restrictedbooleanread-only

Content withheld by Discord (MESSAGE_CONTENT intent missing)

urlstring (uri)read-only

Responses

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

Discord: Get a Messages item

GET/accounts/{accountId}/discord/messages/{itemId}

Channel and thread history. Without the MESSAGE_CONTENT intent Discord withholds other users' message content (content_restricted). Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY. Network docs: https://docs.discord.com/developers/resources/message Generic route: /v1/accounts/{accountId}/focus/messages.

Access: read

Try it with MCPAsk your agent to call discord-messages-get (toolset focus_discord)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

idstringread-only

channelId:messageId

message_idstringread-only
channel_idstring
textstring | null

≤ 2000 characters

authorstring | nullread-only
author_idstring | nullread-only
author_avatar_urlstring (uri) | nullread-only
created_atstring (date-time)read-only
edited_atstring (date-time) | nullread-only
like_countintegerread-only
reactionsarray of objectread-only
Show 3 item attributes
emojistring
countinteger
meboolean
reply_to_idstring | nullread-only
attachmentsarray of objectread-only
Show 4 item attributes
idstring
urlstring (uri)
filenamestring
content_typestring | null
embedsarray of objectread-only
content_restrictedbooleanread-only

Content withheld by Discord (MESSAGE_CONTENT intent missing)

urlstring (uri)read-only

Responses

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

Discord: Update a Messages item

PATCH/accounts/{accountId}/discord/messages/{itemId}

Edit Socialit's own messages (others' messages only allow suppressing embeds). Channel and thread history. Without the MESSAGE_CONTENT intent Discord withholds other users' message content (content_restricted). Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY. Network docs: https://docs.discord.com/developers/resources/message Generic route: /v1/accounts/{accountId}/focus/messages.

Access: write

Try it with MCPAsk your agent to call discord-messages-update (toolset focus_discord)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

idstringread-only

channelId:messageId

message_idstringread-only
channel_idstring
textstring | null

≤ 2000 characters

authorstring | nullread-only
author_idstring | nullread-only
author_avatar_urlstring (uri) | nullread-only
created_atstring (date-time)read-only
edited_atstring (date-time) | nullread-only
like_countintegerread-only
reactionsarray of objectread-only
Show 3 item attributes
emojistring
countinteger
meboolean
reply_to_idstring | nullread-only
attachmentsarray of objectread-only
Show 4 item attributes
idstring
urlstring (uri)
filenamestring
content_typestring | null
embedsarray of objectread-only
content_restrictedbooleanread-only

Content withheld by Discord (MESSAGE_CONTENT intent missing)

urlstring (uri)read-only

Responses

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

Discord: Delete a Messages item

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

Channel and thread history. Without the MESSAGE_CONTENT intent Discord withholds other users' message content (content_restricted). Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY, permission:MANAGE_MESSAGES. Network docs: https://docs.discord.com/developers/resources/message Generic route: /v1/accounts/{accountId}/focus/messages.

Access: writeZernio: DELETE /v1/discord/channels/{channelId}/messages/{messageId}

Try it with MCPAsk your agent to call discord-messages-delete (toolset focus_discord)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}/discord/messages/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/messages/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Discord: Pin (Messages)

POST/accounts/{accountId}/discord/messages/{itemId}/pin

Pin. Channel and thread history. Without the MESSAGE_CONTENT intent Discord withholds other users' message content (content_restricted). Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY, permission:PIN_MESSAGES. Network docs: https://docs.discord.com/developers/resources/message Generic route: /v1/accounts/{accountId}/focus/messages.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call discord-messages-pin (toolset focus_discord)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}/discord/messages/{itemId}/pin
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/messages/ITEM_ID/pin" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Discord: Unpin (Messages)

POST/accounts/{accountId}/discord/messages/{itemId}/unpin

Unpin. Channel and thread history. Without the MESSAGE_CONTENT intent Discord withholds other users' message content (content_restricted). Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY, permission:PIN_MESSAGES. Network docs: https://docs.discord.com/developers/resources/message Generic route: /v1/accounts/{accountId}/focus/messages.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call discord-messages-unpin (toolset focus_discord)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}/discord/messages/{itemId}/unpin
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/messages/ITEM_ID/unpin" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Discord: Publish to followers (Messages)

POST/accounts/{accountId}/discord/messages/{itemId}/crosspost

Announcement channels only; 10 per hour per channel. Channel and thread history. Without the MESSAGE_CONTENT intent Discord withholds other users' message content (content_restricted). Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY. Network docs: https://docs.discord.com/developers/resources/message Generic route: /v1/accounts/{accountId}/focus/messages.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call discord-messages-crosspost (toolset focus_discord)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}/discord/messages/{itemId}/crosspost
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/messages/ITEM_ID/crosspost" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Discord: React (Messages)

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

React. Channel and thread history. Without the MESSAGE_CONTENT intent Discord withholds other users' message content (content_restricted). Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY, permission:ADD_REACTIONS. Network docs: https://docs.discord.com/developers/resources/message Generic route: /v1/accounts/{accountId}/focus/messages.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call discord-messages-react (toolset focus_discord)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

emojistringrequired

Unicode emoji or name:id

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}/discord/messages/{itemId}/react
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/messages/ITEM_ID/react" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "emoji": "string"
  }'
Response · 200

Discord: Remove my reaction (Messages)

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

Remove my reaction. Channel and thread history. Without the MESSAGE_CONTENT intent Discord withholds other users' message content (content_restricted). Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY. Network docs: https://docs.discord.com/developers/resources/message Generic route: /v1/accounts/{accountId}/focus/messages.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call discord-messages-unreact (toolset focus_discord)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

emojistringrequired

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}/discord/messages/{itemId}/unreact
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/messages/ITEM_ID/unreact" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "emoji": "string"
  }'
Response · 200

Discord: Clear reactions (Messages)

POST/accounts/{accountId}/discord/messages/{itemId}/clear-reactions

Clear reactions. Channel and thread history. Without the MESSAGE_CONTENT intent Discord withholds other users' message content (content_restricted). Destructive. Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY, permission:MANAGE_MESSAGES. Network docs: https://docs.discord.com/developers/resources/message Generic route: /v1/accounts/{accountId}/focus/messages.

Access: write

Try it with MCPAsk your agent to call discord-messages-clear-reactions (toolset focus_discord)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

emojistring

Only this emoji (optional)

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}/discord/messages/{itemId}/clear-reactions
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/messages/ITEM_ID/clear-reactions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "emoji": "string"
  }'
Response · 200

Discord: Who reacted (Messages)

POST/accounts/{accountId}/discord/messages/{itemId}/reactors

Who reacted. Channel and thread history. Without the MESSAGE_CONTENT intent Discord withholds other users' message content (content_restricted). Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY. Network docs: https://docs.discord.com/developers/resources/message Generic route: /v1/accounts/{accountId}/focus/messages.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call discord-messages-reactors (toolset focus_discord)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

emojistringrequired
typeinteger

0 normal, 1 super

01

afterstring
limitinteger

≤ 100

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}/discord/messages/{itemId}/reactors
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/messages/ITEM_ID/reactors" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "emoji": "string",
    "type": 0,
    "after": "string",
    "limit": 1
  }'
Response · 200

Discord: Start thread (Messages)

POST/accounts/{accountId}/discord/messages/{itemId}/create-thread

Start thread. Channel and thread history. Without the MESSAGE_CONTENT intent Discord withholds other users' message content (content_restricted). Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY, permission:CREATE_PUBLIC_THREADS. Network docs: https://docs.discord.com/developers/resources/message Generic route: /v1/accounts/{accountId}/focus/messages.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call discord-messages-create-thread (toolset focus_discord)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

namestringrequired

≤ 100 characters

auto_archive_durationinteger

601440432010080

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}/discord/messages/{itemId}/create-thread
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/messages/ITEM_ID/create-thread" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "auto_archive_duration": 60
  }'
Response · 200

Discord: End poll (Messages)

POST/accounts/{accountId}/discord/messages/{itemId}/end-poll

End poll. Channel and thread history. Without the MESSAGE_CONTENT intent Discord withholds other users' message content (content_restricted). Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY. Network docs: https://docs.discord.com/developers/resources/message Generic route: /v1/accounts/{accountId}/focus/messages.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call discord-messages-end-poll (toolset focus_discord)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}/discord/messages/{itemId}/end-poll
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/messages/ITEM_ID/end-poll" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Discord: Poll voters (Messages)

POST/accounts/{accountId}/discord/messages/{itemId}/poll-voters

Poll voters. Channel and thread history. Without the MESSAGE_CONTENT intent Discord withholds other users' message content (content_restricted). Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY. Network docs: https://docs.discord.com/developers/resources/message Generic route: /v1/accounts/{accountId}/focus/messages.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call discord-messages-poll-voters (toolset focus_discord)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

answer_idintegerrequired
afterstring
limitinteger

≤ 100

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}/discord/messages/{itemId}/poll-voters
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/messages/ITEM_ID/poll-voters" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "answer_id": 1,
    "after": "string",
    "limit": 1
  }'
Response · 200
POST/accounts/{accountId}/discord/messages/search

Guild message search; returns indexing=true with retry_after while Discord builds the index. Channel and thread history. Without the MESSAGE_CONTENT intent Discord withholds other users' message content (content_restricted). Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY, intent:MESSAGE_CONTENT. Network docs: https://docs.discord.com/developers/resources/message Generic route: /v1/accounts/{accountId}/focus/messages.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call discord-messages-search (toolset focus_discord)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

contentstring
author_idstring
channel_idstring
mentionsstring
hasstring

linkembedfilepollimagevideosoundstickersnapshot

pinnedboolean
limitinteger

1–25

offsetinteger

0–9975

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}/discord/messages/search
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/messages/search" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "string",
    "author_id": "string",
    "channel_id": "string",
    "mentions": "string",
    "has": "link"
  }'
Response · 200

Discord: Bulk delete (Messages)

POST/accounts/{accountId}/discord/messages/bulk-delete

2-100 messages younger than 14 days. Channel and thread history. Without the MESSAGE_CONTENT intent Discord withholds other users' message content (content_restricted). Destructive. Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY, permission:MANAGE_MESSAGES. Network docs: https://docs.discord.com/developers/resources/message Generic route: /v1/accounts/{accountId}/focus/messages.

Access: write

Try it with MCPAsk your agent to call discord-messages-bulk-delete (toolset focus_discord)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

channel_idstring
message_idsarray of stringrequired

2–100 items

reasonstring

Shown in the server audit log

≤ 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}/discord/messages/bulk-delete
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/messages/bulk-delete" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "channel_id": "string",
    "message_ids": [
      "string"
    ],
    "reason": "string"
  }'
Response · 200

Pins

Discord: List Pinned messages

GET/accounts/{accountId}/discord/pins

Pins per channel (≤250 per channel). Cursor pagination: pass next_cursor back as cursor. Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY. Network docs: https://docs.discord.com/developers/resources/message#get-channel-pins Generic route: /v1/accounts/{accountId}/focus/pins.

Access: readZernio: GET /v1/discord/channels/{channelId}/pins

Try it with MCPAsk your agent to call discord-pins-list (toolset focus_discord)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

channel_idstring
beforestring (date-time)

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 17 item attributes
idstringread-only

channelId:messageId

message_idstringread-only
channel_idstring
textstring | null

≤ 2000 characters

authorstring | nullread-only
author_idstring | nullread-only
author_avatar_urlstring (uri) | nullread-only
created_atstring (date-time)read-only
edited_atstring (date-time) | nullread-only
like_countintegerread-only
reactionsarray of objectread-only
Show 3 item attributes
emojistring
countinteger
meboolean
reply_to_idstring | nullread-only
attachmentsarray of objectread-only
Show 4 item attributes
idstring
urlstring (uri)
filenamestring
content_typestring | null
embedsarray of objectread-only
content_restrictedbooleanread-only

Content withheld by Discord (MESSAGE_CONTENT intent missing)

urlstring (uri)read-only
pinned_atstring (date-time)read-only
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}/discord/pins
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/pins" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Discord: Create a Pinned messages item

POST/accounts/{accountId}/discord/pins

Pins per channel (≤250 per channel). Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY, permission:PIN_MESSAGES. Network docs: https://docs.discord.com/developers/resources/message#get-channel-pins Generic route: /v1/accounts/{accountId}/focus/pins.

Access: writeIdempotency-KeyZernio: PUT /v1/discord/channels/{channelId}/pins/{messageId}

Try it with MCPAsk your agent to call discord-pins-create (toolset focus_discord)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

message_idstringrequired

channel:message or message id

channel_idstring

Returns object

idstringread-only

channelId:messageId

message_idstringread-only
channel_idstring
textstring | null

≤ 2000 characters

authorstring | nullread-only
author_idstring | nullread-only
author_avatar_urlstring (uri) | nullread-only
created_atstring (date-time)read-only
edited_atstring (date-time) | nullread-only
like_countintegerread-only
reactionsarray of objectread-only
Show 3 item attributes
emojistring
countinteger
meboolean
reply_to_idstring | nullread-only
attachmentsarray of objectread-only
Show 4 item attributes
idstring
urlstring (uri)
filenamestring
content_typestring | null
embedsarray of objectread-only
content_restrictedbooleanread-only

Content withheld by Discord (MESSAGE_CONTENT intent missing)

urlstring (uri)read-only
pinned_atstring (date-time)read-only

Responses

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

Discord: Delete a Pinned messages item

DELETE/accounts/{accountId}/discord/pins/{itemId}

Pins per channel (≤250 per channel). Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY, permission:PIN_MESSAGES. Network docs: https://docs.discord.com/developers/resources/message#get-channel-pins Generic route: /v1/accounts/{accountId}/focus/pins.

Access: writeZernio: DELETE /v1/discord/channels/{channelId}/pins/{messageId}

Try it with MCPAsk your agent to call discord-pins-delete (toolset focus_discord)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}/discord/pins/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/pins/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Direct messages

Discord: Create a Direct messages item

POST/accounts/{accountId}/discord/direct-messages

Send a DM from the Socialit bot to a member of this server. DMs should be user-initiated; Discord blocks mass DMs. Requires scopes: bot. Network docs: https://docs.discord.com/developers/resources/user#create-dm Generic route: /v1/accounts/{accountId}/focus/direct-messages.

Access: writeIdempotency-KeyZernio: POST /v1/discord/dms

Try it with MCPAsk your agent to call discord-direct-messages-create (toolset focus_discord)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

userIdstringrequired

pattern ^\d{15,21}$

contentstring

≤ 2000 characters

embedsarray of object

≤ 10 items

attachmentsarray of object

≤ 10 items

Show 4 item attributes
urlstring (uri)
typestring

imagevideogifdocument

filenamestring
mimeTypestring
ttsboolean

Responses

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

Engagement

Discord: List Post engagement

GET/accounts/{accountId}/discord/engagement

Reactions and replies on recent messages (Discord exposes no views or reach). Cursor pagination: pass next_cursor back as cursor. Requires scopes: bot, permission:READ_MESSAGE_HISTORY. Generic route: /v1/accounts/{accountId}/focus/engagement.

Access: read

Try it with MCPAsk your agent to call discord-engagement-list (toolset focus_discord)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

channel_idstring
limitintegerdefault: 20

1–50

only_socialitbooleandefault: true

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 7 item attributes
idstring
created_atstring (date-time)
textstring | null
likesinteger

Reactions

commentsinteger

Thread + inline replies

reactionsarray of object
Show 2 item attributes
emojistring
countinteger
pollobject | 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}/discord/engagement
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/engagement" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Members

Discord: List Members

GET/accounts/{accountId}/discord/members

Server members: search, roles, nicknames and moderation. Listing every member needs the privileged GUILD_MEMBERS intent; search and lookup do not. Cursor pagination: pass next_cursor back as cursor. Requires scopes: bot, intent:GUILD_MEMBERS. Network docs: https://docs.discord.com/developers/resources/guild#guild-member-object Generic route: /v1/accounts/{accountId}/focus/members.

Access: readZernio: GET /v1/discord/guilds/{guildId}/membersGET /v1/discord/guilds/{guildId}/members/search

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

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 100

1–1000

afterstring
querystring

Prefix search instead of listing

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 11 item attributes
idstringread-only
usernamestring | nullread-only
global_namestring | nullread-only
nickstring | null

≤ 32 characters

display_namestring | nullread-only
botbooleanread-only
rolesarray of string
joined_atstring (date-time) | nullread-only
premium_sincestring (date-time) | nullread-only
pendingbooleanread-only
communication_disabled_untilstring (date-time) | null

Timeout end (≤28 days)

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}/discord/members
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/members" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Discord: Get a Members item

GET/accounts/{accountId}/discord/members/{itemId}

Server members: search, roles, nicknames and moderation. Listing every member needs the privileged GUILD_MEMBERS intent; search and lookup do not. Requires scopes: bot. Network docs: https://docs.discord.com/developers/resources/guild#guild-member-object Generic route: /v1/accounts/{accountId}/focus/members.

Access: readZernio: GET /v1/discord/guilds/{guildId}/members/{userId}

Try it with MCPAsk your agent to call discord-members-get (toolset focus_discord)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

idstringread-only
usernamestring | nullread-only
global_namestring | nullread-only
nickstring | null

≤ 32 characters

display_namestring | nullread-only
botbooleanread-only
rolesarray of string
joined_atstring (date-time) | nullread-only
premium_sincestring (date-time) | nullread-only
pendingbooleanread-only
communication_disabled_untilstring (date-time) | null

Timeout end (≤28 days)

Responses

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

Discord: Update a Members item

PATCH/accounts/{accountId}/discord/members/{itemId}

nick (MANAGE_NICKNAMES), roles (MANAGE_ROLES), communication_disabled_until (MODERATE_MEMBERS). Server members: search, roles, nicknames and moderation. Listing every member needs the privileged GUILD_MEMBERS intent; search and lookup do not. Requires scopes: bot, permission:MANAGE_NICKNAMES. Network docs: https://docs.discord.com/developers/resources/guild#guild-member-object Generic route: /v1/accounts/{accountId}/focus/members.

Access: writeZernio: PUT /v1/discord/guilds/{guildId}/members/{userId}/roles/{roleId}

Try it with MCPAsk your agent to call discord-members-update (toolset focus_discord)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

idstringread-only
usernamestring | nullread-only
global_namestring | nullread-only
nickstring | null

≤ 32 characters

display_namestring | nullread-only
botbooleanread-only
rolesarray of string
joined_atstring (date-time) | nullread-only
premium_sincestring (date-time) | nullread-only
pendingbooleanread-only
communication_disabled_untilstring (date-time) | null

Timeout end (≤28 days)

Responses

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

Discord: Delete a Members item

DELETE/accounts/{accountId}/discord/members/{itemId}

Kick. Server members: search, roles, nicknames and moderation. Listing every member needs the privileged GUILD_MEMBERS intent; search and lookup do not. Requires scopes: bot, permission:KICK_MEMBERS. Network docs: https://docs.discord.com/developers/resources/guild#guild-member-object Generic route: /v1/accounts/{accountId}/focus/members.

Access: writeZernio: DELETE /v1/discord/guilds/{guildId}/members/{userId}/roles/{roleId}

Try it with MCPAsk your agent to call discord-members-delete (toolset focus_discord)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}/discord/members/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/members/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
POST/accounts/{accountId}/discord/members/search

Search. Server members: search, roles, nicknames and moderation. Listing every member needs the privileged GUILD_MEMBERS intent; search and lookup do not. Requires scopes: bot. Network docs: https://docs.discord.com/developers/resources/guild#guild-member-object Generic route: /v1/accounts/{accountId}/focus/members.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call discord-members-search (toolset focus_discord)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

querystringrequired
limitintegerdefault: 25

1–1000

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}/discord/members/search
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/members/search" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "string",
    "limit": 25
  }'
Response · 200

Discord: Add role (Members)

POST/accounts/{accountId}/discord/members/{itemId}/add-role

Add role. Server members: search, roles, nicknames and moderation. Listing every member needs the privileged GUILD_MEMBERS intent; search and lookup do not. Requires scopes: bot, permission:MANAGE_ROLES. Network docs: https://docs.discord.com/developers/resources/guild#guild-member-object Generic route: /v1/accounts/{accountId}/focus/members.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call discord-members-add-role (toolset focus_discord)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

role_idstringrequired
reasonstring

Shown in the server audit log

≤ 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}/discord/members/{itemId}/add-role
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/members/ITEM_ID/add-role" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "role_id": "string",
    "reason": "string"
  }'
Response · 200

Discord: Remove role (Members)

POST/accounts/{accountId}/discord/members/{itemId}/remove-role

Remove role. Server members: search, roles, nicknames and moderation. Listing every member needs the privileged GUILD_MEMBERS intent; search and lookup do not. Requires scopes: bot, permission:MANAGE_ROLES. Network docs: https://docs.discord.com/developers/resources/guild#guild-member-object Generic route: /v1/accounts/{accountId}/focus/members.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call discord-members-remove-role (toolset focus_discord)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

role_idstringrequired
reasonstring

Shown in the server audit log

≤ 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}/discord/members/{itemId}/remove-role
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/members/ITEM_ID/remove-role" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "role_id": "string",
    "reason": "string"
  }'
Response · 200

Discord: Timeout (Members)

POST/accounts/{accountId}/discord/members/{itemId}/timeout

Up to 28 days. Server members: search, roles, nicknames and moderation. Listing every member needs the privileged GUILD_MEMBERS intent; search and lookup do not. Requires scopes: bot, permission:MODERATE_MEMBERS. Network docs: https://docs.discord.com/developers/resources/guild#guild-member-object Generic route: /v1/accounts/{accountId}/focus/members.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call discord-members-timeout (toolset focus_discord)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

duration_secondsinteger

60–2419200

untilstring (date-time)
reasonstring

Shown in the server audit log

≤ 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}/discord/members/{itemId}/timeout
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/members/ITEM_ID/timeout" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "duration_seconds": 60,
    "until": "2026-10-13T09:00:00.000Z",
    "reason": "string"
  }'
Response · 200

Discord: Remove timeout (Members)

POST/accounts/{accountId}/discord/members/{itemId}/remove-timeout

Remove timeout. Server members: search, roles, nicknames and moderation. Listing every member needs the privileged GUILD_MEMBERS intent; search and lookup do not. Requires scopes: bot, permission:MODERATE_MEMBERS. Network docs: https://docs.discord.com/developers/resources/guild#guild-member-object Generic route: /v1/accounts/{accountId}/focus/members.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call discord-members-remove-timeout (toolset focus_discord)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}/discord/members/{itemId}/remove-timeout
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/members/ITEM_ID/remove-timeout" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Discord: Kick (Members)

POST/accounts/{accountId}/discord/members/{itemId}/kick

Kick. Server members: search, roles, nicknames and moderation. Listing every member needs the privileged GUILD_MEMBERS intent; search and lookup do not. Destructive. Requires scopes: bot, permission:KICK_MEMBERS. Network docs: https://docs.discord.com/developers/resources/guild#guild-member-object Generic route: /v1/accounts/{accountId}/focus/members.

Access: write

Try it with MCPAsk your agent to call discord-members-kick (toolset focus_discord)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

reasonstring

Shown in the server audit log

≤ 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}/discord/members/{itemId}/kick
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/members/ITEM_ID/kick" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "reason": "string"
  }'
Response · 200

Discord: Ban (Members)

POST/accounts/{accountId}/discord/members/{itemId}/ban

Ban. Server members: search, roles, nicknames and moderation. Listing every member needs the privileged GUILD_MEMBERS intent; search and lookup do not. Destructive. Requires scopes: bot, permission:BAN_MEMBERS. Network docs: https://docs.discord.com/developers/resources/guild#guild-member-object Generic route: /v1/accounts/{accountId}/focus/members.

Access: write

Try it with MCPAsk your agent to call discord-members-ban (toolset focus_discord)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

delete_message_secondsinteger

0–604800

reasonstring

Shown in the server audit log

≤ 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}/discord/members/{itemId}/ban
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/members/ITEM_ID/ban" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "delete_message_seconds": 0,
    "reason": "string"
  }'
Response · 200

Discord: Preview prune (Members)

POST/accounts/{accountId}/discord/members/prune-count

Preview prune. Server members: search, roles, nicknames and moderation. Listing every member needs the privileged GUILD_MEMBERS intent; search and lookup do not. Requires scopes: bot, permission:MANAGE_GUILD, permission:KICK_MEMBERS. Network docs: https://docs.discord.com/developers/resources/guild#guild-member-object Generic route: /v1/accounts/{accountId}/focus/members.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call discord-members-prune-count (toolset focus_discord)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

daysintegerdefault: 7

1–30

include_rolesarray of string

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}/discord/members/prune-count
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/members/prune-count" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "days": 7,
    "include_roles": [
      "string"
    ]
  }'
Response · 200

Discord: Prune inactive members (Members)

POST/accounts/{accountId}/discord/members/prune

Prune inactive members. Server members: search, roles, nicknames and moderation. Listing every member needs the privileged GUILD_MEMBERS intent; search and lookup do not. Destructive. Requires scopes: bot, permission:MANAGE_GUILD, permission:KICK_MEMBERS. Network docs: https://docs.discord.com/developers/resources/guild#guild-member-object Generic route: /v1/accounts/{accountId}/focus/members.

Access: write

Try it with MCPAsk your agent to call discord-members-prune (toolset focus_discord)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

daysintegerrequired

1–30

include_rolesarray of string
reasonstring

Shown in the server audit log

≤ 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}/discord/members/prune
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/members/prune" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "days": 1,
    "include_roles": [
      "string"
    ],
    "reason": "string"
  }'
Response · 200

Roles

Discord: List Roles

GET/accounts/{accountId}/discord/roles

Roles with member counts. The Socialit bot can only manage roles below its own highest role. Cursor pagination: pass next_cursor back as cursor. Requires scopes: bot. Network docs: https://docs.discord.com/developers/topics/permissions#role-object Generic route: /v1/accounts/{accountId}/focus/roles.

Access: readZernio: GET /v1/discord/guilds/{guildId}/roles

Try it with MCPAsk your agent to call discord-roles-list (toolset focus_discord)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 12 item attributes
idstringread-only
namestringrequired

≤ 100 characters

colorinteger

Primary color (decimal)

colorsobject | null
Show 3 child attributes
primary_colorinteger
secondary_colorinteger | null
tertiary_colorinteger | null
positionintegerread-only
permissionsstring

Permission bitfield (string) or array of flag names on write

permission_namesarray of stringread-only
managedbooleanread-only
mentionableboolean
hoistboolean

Show separately in the member list

unicode_emojistring | null
member_countinteger | nullread-only
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}/discord/roles
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/roles" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Discord: Create a Roles item

POST/accounts/{accountId}/discord/roles

Roles with member counts. The Socialit bot can only manage roles below its own highest role. Requires scopes: bot, permission:MANAGE_ROLES. Network docs: https://docs.discord.com/developers/topics/permissions#role-object Generic route: /v1/accounts/{accountId}/focus/roles.

Access: writeIdempotency-KeyZernio: POST /v1/discord/guilds/{guildId}/roles

Try it with MCPAsk your agent to call discord-roles-create (toolset focus_discord)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

≤ 100 characters

colorinteger

Primary color (decimal)

colorsobject | null
Show 3 child attributes
primary_colorinteger
secondary_colorinteger | null
tertiary_colorinteger | null
permissionsstring

Permission bitfield (string) or array of flag names on write

mentionableboolean
hoistboolean

Show separately in the member list

unicode_emojistring | null

Returns object

idstringread-only
namestringrequired

≤ 100 characters

colorinteger

Primary color (decimal)

colorsobject | null
Show 3 child attributes
primary_colorinteger
secondary_colorinteger | null
tertiary_colorinteger | null
positionintegerread-only
permissionsstring

Permission bitfield (string) or array of flag names on write

permission_namesarray of stringread-only
managedbooleanread-only
mentionableboolean
hoistboolean

Show separately in the member list

unicode_emojistring | null
member_countinteger | nullread-only

Responses

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

Discord: Get a Roles item

GET/accounts/{accountId}/discord/roles/{itemId}

Roles with member counts. The Socialit bot can only manage roles below its own highest role. Requires scopes: bot. Network docs: https://docs.discord.com/developers/topics/permissions#role-object Generic route: /v1/accounts/{accountId}/focus/roles.

Access: read

Try it with MCPAsk your agent to call discord-roles-get (toolset focus_discord)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

idstringread-only
namestringrequired

≤ 100 characters

colorinteger

Primary color (decimal)

colorsobject | null
Show 3 child attributes
primary_colorinteger
secondary_colorinteger | null
tertiary_colorinteger | null
positionintegerread-only
permissionsstring

Permission bitfield (string) or array of flag names on write

permission_namesarray of stringread-only
managedbooleanread-only
mentionableboolean
hoistboolean

Show separately in the member list

unicode_emojistring | null
member_countinteger | nullread-only

Responses

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

Discord: Update a Roles item

PATCH/accounts/{accountId}/discord/roles/{itemId}

Roles with member counts. The Socialit bot can only manage roles below its own highest role. Requires scopes: bot, permission:MANAGE_ROLES. Network docs: https://docs.discord.com/developers/topics/permissions#role-object Generic route: /v1/accounts/{accountId}/focus/roles.

Access: writeZernio: PATCH /v1/discord/guilds/{guildId}/roles/{roleId}

Try it with MCPAsk your agent to call discord-roles-update (toolset focus_discord)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

idstringread-only
namestringrequired

≤ 100 characters

colorinteger

Primary color (decimal)

colorsobject | null
Show 3 child attributes
primary_colorinteger
secondary_colorinteger | null
tertiary_colorinteger | null
positionintegerread-only
permissionsstring

Permission bitfield (string) or array of flag names on write

permission_namesarray of stringread-only
managedbooleanread-only
mentionableboolean
hoistboolean

Show separately in the member list

unicode_emojistring | null
member_countinteger | nullread-only

Responses

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

Discord: Delete a Roles item

DELETE/accounts/{accountId}/discord/roles/{itemId}

Roles with member counts. The Socialit bot can only manage roles below its own highest role. Requires scopes: bot, permission:MANAGE_ROLES. Network docs: https://docs.discord.com/developers/topics/permissions#role-object Generic route: /v1/accounts/{accountId}/focus/roles.

Access: writeZernio: DELETE /v1/discord/guilds/{guildId}/roles/{roleId}

Try it with MCPAsk your agent to call discord-roles-delete (toolset focus_discord)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}/discord/roles/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/roles/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Discord: Reorder roles (Roles)

POST/accounts/{accountId}/discord/roles/reorder

Reorder roles. Roles with member counts. The Socialit bot can only manage roles below its own highest role. Requires scopes: bot, permission:MANAGE_ROLES. Network docs: https://docs.discord.com/developers/topics/permissions#role-object Generic route: /v1/accounts/{accountId}/focus/roles.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call discord-roles-reorder (toolset focus_discord)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

positionsarray of objectrequired

≥ 1 items

Show 2 item attributes
idstring
positioninteger

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}/discord/roles/reorder
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/roles/reorder" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "positions": [
      {
        "id": "string",
        "position": 1
      }
    ]
  }'
Response · 200

Bans

Discord: List Bans

GET/accounts/{accountId}/discord/bans

Cursor pagination: pass next_cursor back as cursor. Requires scopes: bot, permission:BAN_MEMBERS. Network docs: https://docs.discord.com/developers/resources/guild#ban-object Generic route: /v1/accounts/{accountId}/focus/bans.

Access: read

Try it with MCPAsk your agent to call discord-bans-list (toolset focus_discord)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitinteger

1–1000

afterstring
beforestring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 4 item attributes
idstringrequired

User id

usernamestring | nullread-only
global_namestring | nullread-only
reasonstring | null

≤ 512 characters

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}/discord/bans
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/bans" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Discord: Create a Bans item

POST/accounts/{accountId}/discord/bans

Requires scopes: bot, permission:BAN_MEMBERS. Network docs: https://docs.discord.com/developers/resources/guild#ban-object Generic route: /v1/accounts/{accountId}/focus/bans.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call discord-bans-create (toolset focus_discord)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

User id

reasonstring | null

≤ 512 characters

delete_message_secondsinteger

0–604800

Returns object

idstringrequired

User id

usernamestring | nullread-only
global_namestring | nullread-only
reasonstring | null

≤ 512 characters

Responses

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

Discord: Get a Bans item

GET/accounts/{accountId}/discord/bans/{itemId}

Requires scopes: bot, permission:BAN_MEMBERS. Network docs: https://docs.discord.com/developers/resources/guild#ban-object Generic route: /v1/accounts/{accountId}/focus/bans.

Access: read

Try it with MCPAsk your agent to call discord-bans-get (toolset focus_discord)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

User id

usernamestring | nullread-only
global_namestring | nullread-only
reasonstring | null

≤ 512 characters

Responses

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

Discord: Delete a Bans item

DELETE/accounts/{accountId}/discord/bans/{itemId}

Requires scopes: bot, permission:BAN_MEMBERS. Network docs: https://docs.discord.com/developers/resources/guild#ban-object Generic route: /v1/accounts/{accountId}/focus/bans.

Access: write

Try it with MCPAsk your agent to call discord-bans-delete (toolset focus_discord)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}/discord/bans/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/bans/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Discord: Bulk ban (Bans)

POST/accounts/{accountId}/discord/bans/bulk-ban

Bulk ban. Destructive. Requires scopes: bot, permission:BAN_MEMBERS, permission:MANAGE_GUILD. Network docs: https://docs.discord.com/developers/resources/guild#ban-object Generic route: /v1/accounts/{accountId}/focus/bans.

Access: write

Try it with MCPAsk your agent to call discord-bans-bulk-ban (toolset focus_discord)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

user_idsarray of stringrequired

1–200 items

delete_message_secondsinteger

0–604800

reasonstring

Shown in the server audit log

≤ 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}/discord/bans/bulk-ban
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/bans/bulk-ban" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "user_ids": [
      "string"
    ],
    "delete_message_seconds": 0,
    "reason": "string"
  }'
Response · 200

Invites

Discord: List Invites

GET/accounts/{accountId}/discord/invites

Campaign invites with usage counts (≤1000 per server). Cursor pagination: pass next_cursor back as cursor. Requires scopes: bot, permission:MANAGE_GUILD. Network docs: https://docs.discord.com/developers/resources/invite Generic route: /v1/accounts/{accountId}/focus/invites.

Access: read

Try it with MCPAsk your agent to call discord-invites-list (toolset focus_discord)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 12 item attributes
codestringread-only
urlstring (uri)read-only
channel_idstring
inviterstring | nullread-only
usesintegerread-only
max_usesinteger

0–100

max_ageinteger

Seconds; 0 = never expires

0–604800

temporaryboolean

Kick when they disconnect unless given a role

uniqueboolean
role_idsarray of string

Roles granted on join (MANAGE_ROLES)

created_atstring (date-time) | nullread-only
expires_atstring (date-time) | nullread-only
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}/discord/invites
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/invites" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Discord: Create a Invites item

POST/accounts/{accountId}/discord/invites

Campaign invites with usage counts (≤1000 per server). Requires scopes: bot, permission:MANAGE_GUILD, permission:CREATE_INSTANT_INVITE. Network docs: https://docs.discord.com/developers/resources/invite Generic route: /v1/accounts/{accountId}/focus/invites.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call discord-invites-create (toolset focus_discord)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

channel_idstring
max_usesinteger

0–100

max_ageinteger

Seconds; 0 = never expires

0–604800

temporaryboolean

Kick when they disconnect unless given a role

uniqueboolean
role_idsarray of string

Roles granted on join (MANAGE_ROLES)

Returns object

codestringread-only
urlstring (uri)read-only
channel_idstring
inviterstring | nullread-only
usesintegerread-only
max_usesinteger

0–100

max_ageinteger

Seconds; 0 = never expires

0–604800

temporaryboolean

Kick when they disconnect unless given a role

uniqueboolean
role_idsarray of string

Roles granted on join (MANAGE_ROLES)

created_atstring (date-time) | nullread-only
expires_atstring (date-time) | nullread-only

Responses

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

Discord: Get a Invites item

GET/accounts/{accountId}/discord/invites/{itemId}

Campaign invites with usage counts (≤1000 per server). Requires scopes: bot, permission:MANAGE_GUILD. Network docs: https://docs.discord.com/developers/resources/invite Generic route: /v1/accounts/{accountId}/focus/invites.

Access: read

Try it with MCPAsk your agent to call discord-invites-get (toolset focus_discord)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

codestringread-only
urlstring (uri)read-only
channel_idstring
inviterstring | nullread-only
usesintegerread-only
max_usesinteger

0–100

max_ageinteger

Seconds; 0 = never expires

0–604800

temporaryboolean

Kick when they disconnect unless given a role

uniqueboolean
role_idsarray of string

Roles granted on join (MANAGE_ROLES)

created_atstring (date-time) | nullread-only
expires_atstring (date-time) | nullread-only

Responses

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

Discord: Delete a Invites item

DELETE/accounts/{accountId}/discord/invites/{itemId}

Campaign invites with usage counts (≤1000 per server). Requires scopes: bot, permission:MANAGE_GUILD. Network docs: https://docs.discord.com/developers/resources/invite Generic route: /v1/accounts/{accountId}/focus/invites.

Access: write

Try it with MCPAsk your agent to call discord-invites-delete (toolset focus_discord)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}/discord/invites/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/invites/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Discord: Vanity URL (Invites)

POST/accounts/{accountId}/discord/invites/vanity

Vanity URL. Campaign invites with usage counts (≤1000 per server). Requires scopes: bot, permission:MANAGE_GUILD. Network docs: https://docs.discord.com/developers/resources/invite Generic route: /v1/accounts/{accountId}/focus/invites.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call discord-invites-vanity (toolset focus_discord)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}/discord/invites/vanity
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/invites/vanity" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Scheduled events

Discord: List Events

GET/accounts/{accountId}/discord/scheduled-events

Scheduled events (voice, stage, external; recurring) with RSVP counts. ≤100 scheduled or active per server. Cursor pagination: pass next_cursor back as cursor. Requires scopes: bot. Network docs: https://docs.discord.com/developers/resources/guild-scheduled-event Generic route: /v1/accounts/{accountId}/focus/scheduled-events.

Access: readZernio: GET /v1/discord/guilds/{guildId}/events

Try it with MCPAsk your agent to call discord-scheduled-events-list (toolset focus_discord)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 12 item attributes
idstringread-only
namestringrequired

≤ 100 characters

descriptionstring | null

≤ 1000 characters

starts_atstring (date-time)required
ends_atstring (date-time) | null
statusstring

scheduledactivecompletedcancelled

entity_typestringrequired

externalvoicestage

channel_idstring | null
locationstring | null

≤ 100 characters

user_countinteger | nullread-only
imagestring | null
recurrence_ruleobject | null
Show 7 child attributes
startstring (date-time)
frequencyinteger

0 yearly, 1 monthly, 2 weekly, 3 daily

0123

intervalinteger
by_weekdayarray of integer | null
by_n_weekdayarray of object | null
Show 2 item attributes
ninteger
dayinteger
by_montharray of integer | null
by_month_dayarray of integer | 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}/discord/scheduled-events
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/scheduled-events" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Discord: Create a Events item

POST/accounts/{accountId}/discord/scheduled-events

Scheduled events (voice, stage, external; recurring) with RSVP counts. ≤100 scheduled or active per server. Requires scopes: bot, permission:CREATE_EVENTS. Network docs: https://docs.discord.com/developers/resources/guild-scheduled-event Generic route: /v1/accounts/{accountId}/focus/scheduled-events.

Access: writeIdempotency-KeyZernio: POST /v1/discord/guilds/{guildId}/events

Try it with MCPAsk your agent to call discord-scheduled-events-create (toolset focus_discord)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

≤ 100 characters

descriptionstring | null

≤ 1000 characters

starts_atstring (date-time)required
ends_atstring (date-time) | null
statusstring

scheduledactivecompletedcancelled

entity_typestringrequired

externalvoicestage

channel_idstring | null
locationstring | null

≤ 100 characters

imagestring | null
recurrence_ruleobject | null
Show 7 child attributes
startstring (date-time)
frequencyinteger

0 yearly, 1 monthly, 2 weekly, 3 daily

0123

intervalinteger
by_weekdayarray of integer | null
by_n_weekdayarray of object | null
Show 2 item attributes
ninteger
dayinteger
by_montharray of integer | null
by_month_dayarray of integer | null

Returns object

idstringread-only
namestringrequired

≤ 100 characters

descriptionstring | null

≤ 1000 characters

starts_atstring (date-time)required
ends_atstring (date-time) | null
statusstring

scheduledactivecompletedcancelled

entity_typestringrequired

externalvoicestage

channel_idstring | null
locationstring | null

≤ 100 characters

user_countinteger | nullread-only
imagestring | null
recurrence_ruleobject | null
Show 7 child attributes
startstring (date-time)
frequencyinteger

0 yearly, 1 monthly, 2 weekly, 3 daily

0123

intervalinteger
by_weekdayarray of integer | null
by_n_weekdayarray of object | null
Show 2 item attributes
ninteger
dayinteger
by_montharray of integer | null
by_month_dayarray of integer | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/discord/scheduled-events
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/scheduled-events" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "description": "string",
    "starts_at": "2026-10-13T09:00:00.000Z",
    "ends_at": "2026-10-13T09:00:00.000Z",
    "entity_type": "external"
  }'
Response · 201

Discord: Get a Events item

GET/accounts/{accountId}/discord/scheduled-events/{itemId}

Scheduled events (voice, stage, external; recurring) with RSVP counts. ≤100 scheduled or active per server. Requires scopes: bot. Network docs: https://docs.discord.com/developers/resources/guild-scheduled-event Generic route: /v1/accounts/{accountId}/focus/scheduled-events.

Access: readZernio: GET /v1/discord/guilds/{guildId}/events/{eventId}

Try it with MCPAsk your agent to call discord-scheduled-events-get (toolset focus_discord)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

idstringread-only
namestringrequired

≤ 100 characters

descriptionstring | null

≤ 1000 characters

starts_atstring (date-time)required
ends_atstring (date-time) | null
statusstring

scheduledactivecompletedcancelled

entity_typestringrequired

externalvoicestage

channel_idstring | null
locationstring | null

≤ 100 characters

user_countinteger | nullread-only
imagestring | null
recurrence_ruleobject | null
Show 7 child attributes
startstring (date-time)
frequencyinteger

0 yearly, 1 monthly, 2 weekly, 3 daily

0123

intervalinteger
by_weekdayarray of integer | null
by_n_weekdayarray of object | null
Show 2 item attributes
ninteger
dayinteger
by_montharray of integer | null
by_month_dayarray of integer | null

Responses

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

Discord: Update a Events item

PATCH/accounts/{accountId}/discord/scheduled-events/{itemId}

Own events need CREATE_EVENTS; events created by others need MANAGE_EVENTS. Scheduled events (voice, stage, external; recurring) with RSVP counts. ≤100 scheduled or active per server. Requires scopes: bot, permission:CREATE_EVENTS. Network docs: https://docs.discord.com/developers/resources/guild-scheduled-event Generic route: /v1/accounts/{accountId}/focus/scheduled-events.

Access: writeZernio: PATCH /v1/discord/guilds/{guildId}/events/{eventId}

Try it with MCPAsk your agent to call discord-scheduled-events-update (toolset focus_discord)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

idstringread-only
namestringrequired

≤ 100 characters

descriptionstring | null

≤ 1000 characters

starts_atstring (date-time)required
ends_atstring (date-time) | null
statusstring

scheduledactivecompletedcancelled

entity_typestringrequired

externalvoicestage

channel_idstring | null
locationstring | null

≤ 100 characters

user_countinteger | nullread-only
imagestring | null
recurrence_ruleobject | null
Show 7 child attributes
startstring (date-time)
frequencyinteger

0 yearly, 1 monthly, 2 weekly, 3 daily

0123

intervalinteger
by_weekdayarray of integer | null
by_n_weekdayarray of object | null
Show 2 item attributes
ninteger
dayinteger
by_montharray of integer | null
by_month_dayarray of integer | null

Responses

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

Discord: Delete a Events item

DELETE/accounts/{accountId}/discord/scheduled-events/{itemId}

Scheduled events (voice, stage, external; recurring) with RSVP counts. ≤100 scheduled or active per server. Requires scopes: bot, permission:CREATE_EVENTS. Network docs: https://docs.discord.com/developers/resources/guild-scheduled-event Generic route: /v1/accounts/{accountId}/focus/scheduled-events.

Access: writeZernio: DELETE /v1/discord/guilds/{guildId}/events/{eventId}

Try it with MCPAsk your agent to call discord-scheduled-events-delete (toolset focus_discord)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}/discord/scheduled-events/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/scheduled-events/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Discord: Interested users (Events)

POST/accounts/{accountId}/discord/scheduled-events/{itemId}/users

Interested users. Scheduled events (voice, stage, external; recurring) with RSVP counts. ≤100 scheduled or active per server. Requires scopes: bot. Network docs: https://docs.discord.com/developers/resources/guild-scheduled-event Generic route: /v1/accounts/{accountId}/focus/scheduled-events.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call discord-scheduled-events-users (toolset focus_discord)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

limitinteger

≤ 100

afterstring

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}/discord/scheduled-events/{itemId}/users
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/scheduled-events/ITEM_ID/users" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "limit": 1,
    "after": "string"
  }'
Response · 200

Discord: Start (Events)

POST/accounts/{accountId}/discord/scheduled-events/{itemId}/start

Start. Scheduled events (voice, stage, external; recurring) with RSVP counts. ≤100 scheduled or active per server. Requires scopes: bot, permission:CREATE_EVENTS. Network docs: https://docs.discord.com/developers/resources/guild-scheduled-event Generic route: /v1/accounts/{accountId}/focus/scheduled-events.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call discord-scheduled-events-start (toolset focus_discord)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}/discord/scheduled-events/{itemId}/start
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/scheduled-events/ITEM_ID/start" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Discord: End (Events)

POST/accounts/{accountId}/discord/scheduled-events/{itemId}/end

End. Scheduled events (voice, stage, external; recurring) with RSVP counts. ≤100 scheduled or active per server. Requires scopes: bot, permission:CREATE_EVENTS. Network docs: https://docs.discord.com/developers/resources/guild-scheduled-event Generic route: /v1/accounts/{accountId}/focus/scheduled-events.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call discord-scheduled-events-end (toolset focus_discord)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}/discord/scheduled-events/{itemId}/end
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/scheduled-events/ITEM_ID/end" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Discord: Cancel (Events)

POST/accounts/{accountId}/discord/scheduled-events/{itemId}/cancel

Cancel. Scheduled events (voice, stage, external; recurring) with RSVP counts. ≤100 scheduled or active per server. Destructive. Requires scopes: bot, permission:CREATE_EVENTS. Network docs: https://docs.discord.com/developers/resources/guild-scheduled-event Generic route: /v1/accounts/{accountId}/focus/scheduled-events.

Access: write

Try it with MCPAsk your agent to call discord-scheduled-events-cancel (toolset focus_discord)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}/discord/scheduled-events/{itemId}/cancel
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/scheduled-events/ITEM_ID/cancel" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Automod rules

Discord: List AutoMod rules

GET/accounts/{accountId}/discord/automod-rules

Keyword, spam, preset, mention-spam and member-profile rules (block, alert, timeout). Cursor pagination: pass next_cursor back as cursor. Requires scopes: bot, permission:MANAGE_GUILD. Network docs: https://docs.discord.com/developers/resources/auto-moderation Generic route: /v1/accounts/{accountId}/focus/automod-rules.

Access: read

Try it with MCPAsk your agent to call discord-automod-rules-list (toolset focus_discord)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 10 item attributes
idstringread-only
namestringrequired

≤ 100 characters

event_typeintegerrequired

1 message send, 2 member update

12

trigger_typeintegerrequired

1 keyword (≤6 rules), 3 spam, 4 keyword preset, 5 mention spam, 6 member profile

13456

trigger_type_namestringread-only
trigger_metadataobject
Show 6 child attributes
keyword_filterarray of string

≤ 1000 items

regex_patternsarray of string

≤ 10 items

presetsarray of integer

1 profanity, 2 sexual content, 3 slurs

allow_listarray of string

≤ 1000 items

mention_total_limitinteger

≤ 50

mention_raid_protection_enabledboolean
actionsarray of objectrequired

≥ 1 items

Show 2 item attributes
typeinteger

1234

metadataobject
Show 3 child attributes
channel_idstring
duration_secondsinteger

≤ 2419200

custom_messagestring

≤ 150 characters

enabledboolean
exempt_rolesarray of string

≤ 20 items

exempt_channelsarray of string

≤ 50 items

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}/discord/automod-rules
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/automod-rules" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Discord: Create a AutoMod rules item

POST/accounts/{accountId}/discord/automod-rules

The timeout action also needs MODERATE_MEMBERS. Keyword, spam, preset, mention-spam and member-profile rules (block, alert, timeout). Requires scopes: bot, permission:MANAGE_GUILD. Network docs: https://docs.discord.com/developers/resources/auto-moderation Generic route: /v1/accounts/{accountId}/focus/automod-rules.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call discord-automod-rules-create (toolset focus_discord)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

≤ 100 characters

event_typeintegerrequired

1 message send, 2 member update

12

trigger_typeintegerrequired

1 keyword (≤6 rules), 3 spam, 4 keyword preset, 5 mention spam, 6 member profile

13456

trigger_metadataobject
Show 6 child attributes
keyword_filterarray of string

≤ 1000 items

regex_patternsarray of string

≤ 10 items

presetsarray of integer

1 profanity, 2 sexual content, 3 slurs

allow_listarray of string

≤ 1000 items

mention_total_limitinteger

≤ 50

mention_raid_protection_enabledboolean
actionsarray of objectrequired

≥ 1 items

Show 2 item attributes
typeinteger

1234

metadataobject
Show 3 child attributes
channel_idstring
duration_secondsinteger

≤ 2419200

custom_messagestring

≤ 150 characters

enabledboolean
exempt_rolesarray of string

≤ 20 items

exempt_channelsarray of string

≤ 50 items

Returns object

idstringread-only
namestringrequired

≤ 100 characters

event_typeintegerrequired

1 message send, 2 member update

12

trigger_typeintegerrequired

1 keyword (≤6 rules), 3 spam, 4 keyword preset, 5 mention spam, 6 member profile

13456

trigger_type_namestringread-only
trigger_metadataobject
Show 6 child attributes
keyword_filterarray of string

≤ 1000 items

regex_patternsarray of string

≤ 10 items

presetsarray of integer

1 profanity, 2 sexual content, 3 slurs

allow_listarray of string

≤ 1000 items

mention_total_limitinteger

≤ 50

mention_raid_protection_enabledboolean
actionsarray of objectrequired

≥ 1 items

Show 2 item attributes
typeinteger

1234

metadataobject
Show 3 child attributes
channel_idstring
duration_secondsinteger

≤ 2419200

custom_messagestring

≤ 150 characters

enabledboolean
exempt_rolesarray of string

≤ 20 items

exempt_channelsarray of string

≤ 50 items

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/discord/automod-rules
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/automod-rules" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "event_type": 1,
    "trigger_type": 1,
    "trigger_metadata": {
      "keyword_filter": [
        "string"
      ],
      "regex_patterns": [
        "string"
      ]
    },
    "actions": [
      {
        "type": 1,
        "metadata": {
          "channel_id": "string",
          "duration_seconds": 1
        }
      }
    ]
  }'
Response · 201

Discord: Get a AutoMod rules item

GET/accounts/{accountId}/discord/automod-rules/{itemId}

Keyword, spam, preset, mention-spam and member-profile rules (block, alert, timeout). Requires scopes: bot, permission:MANAGE_GUILD. Network docs: https://docs.discord.com/developers/resources/auto-moderation Generic route: /v1/accounts/{accountId}/focus/automod-rules.

Access: read

Try it with MCPAsk your agent to call discord-automod-rules-get (toolset focus_discord)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

idstringread-only
namestringrequired

≤ 100 characters

event_typeintegerrequired

1 message send, 2 member update

12

trigger_typeintegerrequired

1 keyword (≤6 rules), 3 spam, 4 keyword preset, 5 mention spam, 6 member profile

13456

trigger_type_namestringread-only
trigger_metadataobject
Show 6 child attributes
keyword_filterarray of string

≤ 1000 items

regex_patternsarray of string

≤ 10 items

presetsarray of integer

1 profanity, 2 sexual content, 3 slurs

allow_listarray of string

≤ 1000 items

mention_total_limitinteger

≤ 50

mention_raid_protection_enabledboolean
actionsarray of objectrequired

≥ 1 items

Show 2 item attributes
typeinteger

1234

metadataobject
Show 3 child attributes
channel_idstring
duration_secondsinteger

≤ 2419200

custom_messagestring

≤ 150 characters

enabledboolean
exempt_rolesarray of string

≤ 20 items

exempt_channelsarray of string

≤ 50 items

Responses

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

Discord: Update a AutoMod rules item

PATCH/accounts/{accountId}/discord/automod-rules/{itemId}

Keyword, spam, preset, mention-spam and member-profile rules (block, alert, timeout). Requires scopes: bot, permission:MANAGE_GUILD. Network docs: https://docs.discord.com/developers/resources/auto-moderation Generic route: /v1/accounts/{accountId}/focus/automod-rules.

Access: write

Try it with MCPAsk your agent to call discord-automod-rules-update (toolset focus_discord)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

idstringread-only
namestringrequired

≤ 100 characters

event_typeintegerrequired

1 message send, 2 member update

12

trigger_typeintegerrequired

1 keyword (≤6 rules), 3 spam, 4 keyword preset, 5 mention spam, 6 member profile

13456

trigger_type_namestringread-only
trigger_metadataobject
Show 6 child attributes
keyword_filterarray of string

≤ 1000 items

regex_patternsarray of string

≤ 10 items

presetsarray of integer

1 profanity, 2 sexual content, 3 slurs

allow_listarray of string

≤ 1000 items

mention_total_limitinteger

≤ 50

mention_raid_protection_enabledboolean
actionsarray of objectrequired

≥ 1 items

Show 2 item attributes
typeinteger

1234

metadataobject
Show 3 child attributes
channel_idstring
duration_secondsinteger

≤ 2419200

custom_messagestring

≤ 150 characters

enabledboolean
exempt_rolesarray of string

≤ 20 items

exempt_channelsarray of string

≤ 50 items

Responses

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

Discord: Delete a AutoMod rules item

DELETE/accounts/{accountId}/discord/automod-rules/{itemId}

Keyword, spam, preset, mention-spam and member-profile rules (block, alert, timeout). Requires scopes: bot, permission:MANAGE_GUILD. Network docs: https://docs.discord.com/developers/resources/auto-moderation Generic route: /v1/accounts/{accountId}/focus/automod-rules.

Access: write

Try it with MCPAsk your agent to call discord-automod-rules-delete (toolset focus_discord)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}/discord/automod-rules/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/automod-rules/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Audit log

Discord: List Audit log

GET/accounts/{accountId}/discord/audit-log

Who did what in the server (45-day retention). Socialit actions carry a "Socialit: …" reason. Cursor pagination: pass next_cursor back as cursor. Requires scopes: bot, permission:VIEW_AUDIT_LOG. Network docs: https://docs.discord.com/developers/resources/audit-log Generic route: /v1/accounts/{accountId}/focus/audit-log.

Access: read

Try it with MCPAsk your agent to call discord-audit-log-list (toolset focus_discord)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

user_idstring
action_typeinteger
beforestring
afterstring
limitintegerdefault: 50

1–100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 9 item attributes
idstring
created_atstring (date-time)
user_idstring | null
userstring | null
action_typeinteger
target_idstring | null
reasonstring | null
changesarray of object
Show 3 item attributes
keystring
old_valueany
new_valueany
optionsobject | 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}/discord/audit-log
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/audit-log" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Emojis

Discord: List Emoji

GET/accounts/{accountId}/discord/emojis

Custom server emoji (≤256 KiB, 128×128; JPEG, PNG, GIF, WebP, AVIF). Cursor pagination: pass next_cursor back as cursor. Requires scopes: bot. Network docs: https://docs.discord.com/developers/resources/emoji Generic route: /v1/accounts/{accountId}/focus/emojis.

Access: read

Try it with MCPAsk your agent to call discord-emojis-list (toolset focus_discord)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 7 item attributes
idstringread-only
namestringrequired

2–32 characters · pattern ^[A-Za-z0-9_]+$

rolesarray of string

Roles allowed to use it

animatedbooleanread-only
urlstring (uri)read-only
markdownstringread-only
creatorstring | nullread-only
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}/discord/emojis
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/emojis" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Discord: Create a Emoji item

POST/accounts/{accountId}/discord/emojis

Custom server emoji (≤256 KiB, 128×128; JPEG, PNG, GIF, WebP, AVIF). Requires scopes: bot, permission:CREATE_GUILD_EXPRESSIONS. Network docs: https://docs.discord.com/developers/resources/emoji Generic route: /v1/accounts/{accountId}/focus/emojis.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call discord-emojis-create (toolset focus_discord)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

idstringread-only
namestringrequired

2–32 characters · pattern ^[A-Za-z0-9_]+$

rolesarray of string

Roles allowed to use it

animatedbooleanread-only
urlstring (uri)read-only
markdownstringread-only
creatorstring | nullread-only

Responses

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

Discord: Get a Emoji item

GET/accounts/{accountId}/discord/emojis/{itemId}

Custom server emoji (≤256 KiB, 128×128; JPEG, PNG, GIF, WebP, AVIF). Requires scopes: bot. Network docs: https://docs.discord.com/developers/resources/emoji Generic route: /v1/accounts/{accountId}/focus/emojis.

Access: read

Try it with MCPAsk your agent to call discord-emojis-get (toolset focus_discord)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

idstringread-only
namestringrequired

2–32 characters · pattern ^[A-Za-z0-9_]+$

rolesarray of string

Roles allowed to use it

animatedbooleanread-only
urlstring (uri)read-only
markdownstringread-only
creatorstring | nullread-only

Responses

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

Discord: Update a Emoji item

PATCH/accounts/{accountId}/discord/emojis/{itemId}

Custom server emoji (≤256 KiB, 128×128; JPEG, PNG, GIF, WebP, AVIF). Requires scopes: bot. Network docs: https://docs.discord.com/developers/resources/emoji Generic route: /v1/accounts/{accountId}/focus/emojis.

Access: write

Try it with MCPAsk your agent to call discord-emojis-update (toolset focus_discord)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

idstringread-only
namestringrequired

2–32 characters · pattern ^[A-Za-z0-9_]+$

rolesarray of string

Roles allowed to use it

animatedbooleanread-only
urlstring (uri)read-only
markdownstringread-only
creatorstring | nullread-only

Responses

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

Discord: Delete a Emoji item

DELETE/accounts/{accountId}/discord/emojis/{itemId}

Custom server emoji (≤256 KiB, 128×128; JPEG, PNG, GIF, WebP, AVIF). Requires scopes: bot. Network docs: https://docs.discord.com/developers/resources/emoji Generic route: /v1/accounts/{accountId}/focus/emojis.

Access: write

Try it with MCPAsk your agent to call discord-emojis-delete (toolset focus_discord)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}/discord/emojis/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/emojis/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Stickers

Discord: List Stickers

GET/accounts/{accountId}/discord/stickers

Server stickers (PNG, APNG, GIF; ≤512 KiB, 320×320). Free servers get 5 slots, more with boosts. Cursor pagination: pass next_cursor back as cursor. Requires scopes: bot. Network docs: https://docs.discord.com/developers/resources/sticker Generic route: /v1/accounts/{accountId}/focus/stickers.

Access: read

Try it with MCPAsk your agent to call discord-stickers-list (toolset focus_discord)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 6 item attributes
idstringread-only
namestringrequired

2–30 characters

descriptionstring | null

≤ 100 characters

tagsstringrequired

Autocomplete/suggestion tags (e.g. a unicode emoji name)

≤ 200 characters

formatstringread-only
urlstring (uri)read-only
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}/discord/stickers
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/stickers" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Discord: Create a Stickers item

POST/accounts/{accountId}/discord/stickers

Server stickers (PNG, APNG, GIF; ≤512 KiB, 320×320). Free servers get 5 slots, more with boosts. Requires scopes: bot, permission:CREATE_GUILD_EXPRESSIONS. Network docs: https://docs.discord.com/developers/resources/sticker Generic route: /v1/accounts/{accountId}/focus/stickers.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call discord-stickers-create (toolset focus_discord)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

idstringread-only
namestringrequired

2–30 characters

descriptionstring | null

≤ 100 characters

tagsstringrequired

Autocomplete/suggestion tags (e.g. a unicode emoji name)

≤ 200 characters

formatstringread-only
urlstring (uri)read-only

Responses

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

Discord: Get a Stickers item

GET/accounts/{accountId}/discord/stickers/{itemId}

Server stickers (PNG, APNG, GIF; ≤512 KiB, 320×320). Free servers get 5 slots, more with boosts. Requires scopes: bot. Network docs: https://docs.discord.com/developers/resources/sticker Generic route: /v1/accounts/{accountId}/focus/stickers.

Access: read

Try it with MCPAsk your agent to call discord-stickers-get (toolset focus_discord)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

idstringread-only
namestringrequired

2–30 characters

descriptionstring | null

≤ 100 characters

tagsstringrequired

Autocomplete/suggestion tags (e.g. a unicode emoji name)

≤ 200 characters

formatstringread-only
urlstring (uri)read-only

Responses

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

Discord: Update a Stickers item

PATCH/accounts/{accountId}/discord/stickers/{itemId}

Server stickers (PNG, APNG, GIF; ≤512 KiB, 320×320). Free servers get 5 slots, more with boosts. Requires scopes: bot. Network docs: https://docs.discord.com/developers/resources/sticker Generic route: /v1/accounts/{accountId}/focus/stickers.

Access: write

Try it with MCPAsk your agent to call discord-stickers-update (toolset focus_discord)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

idstringread-only
namestringrequired

2–30 characters

descriptionstring | null

≤ 100 characters

tagsstringrequired

Autocomplete/suggestion tags (e.g. a unicode emoji name)

≤ 200 characters

formatstringread-only
urlstring (uri)read-only

Responses

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

Discord: Delete a Stickers item

DELETE/accounts/{accountId}/discord/stickers/{itemId}

Server stickers (PNG, APNG, GIF; ≤512 KiB, 320×320). Free servers get 5 slots, more with boosts. Requires scopes: bot. Network docs: https://docs.discord.com/developers/resources/sticker Generic route: /v1/accounts/{accountId}/focus/stickers.

Access: write

Try it with MCPAsk your agent to call discord-stickers-delete (toolset focus_discord)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}/discord/stickers/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/stickers/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Soundboard sounds

Discord: List Soundboard

GET/accounts/{accountId}/discord/soundboard-sounds

Server soundboard sounds (MP3/Ogg, ≤512 KB, ≤5.2 s). Socialit cannot play sounds (no voice connection). Cursor pagination: pass next_cursor back as cursor. Requires scopes: bot. Network docs: https://docs.discord.com/developers/resources/soundboard Generic route: /v1/accounts/{accountId}/focus/soundboard-sounds.

Access: read

Try it with MCPAsk your agent to call discord-soundboard-sounds-list (toolset focus_discord)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 6 item attributes
idstringread-only
namestringrequired

2–32 characters

volumenumberdefault: 1

0–1

emoji_idstring | null
emoji_namestring | null
urlstring (uri)read-only
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}/discord/soundboard-sounds
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/soundboard-sounds" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Discord: Create a Soundboard item

POST/accounts/{accountId}/discord/soundboard-sounds

Server soundboard sounds (MP3/Ogg, ≤512 KB, ≤5.2 s). Socialit cannot play sounds (no voice connection). Requires scopes: bot, permission:CREATE_GUILD_EXPRESSIONS. Network docs: https://docs.discord.com/developers/resources/soundboard Generic route: /v1/accounts/{accountId}/focus/soundboard-sounds.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call discord-soundboard-sounds-create (toolset focus_discord)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

idstringread-only
namestringrequired

2–32 characters

volumenumberdefault: 1

0–1

emoji_idstring | null
emoji_namestring | null
urlstring (uri)read-only

Responses

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

Discord: Get a Soundboard item

GET/accounts/{accountId}/discord/soundboard-sounds/{itemId}

Server soundboard sounds (MP3/Ogg, ≤512 KB, ≤5.2 s). Socialit cannot play sounds (no voice connection). Requires scopes: bot. Network docs: https://docs.discord.com/developers/resources/soundboard Generic route: /v1/accounts/{accountId}/focus/soundboard-sounds.

Access: read

Try it with MCPAsk your agent to call discord-soundboard-sounds-get (toolset focus_discord)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

idstringread-only
namestringrequired

2–32 characters

volumenumberdefault: 1

0–1

emoji_idstring | null
emoji_namestring | null
urlstring (uri)read-only

Responses

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

Discord: Update a Soundboard item

PATCH/accounts/{accountId}/discord/soundboard-sounds/{itemId}

Server soundboard sounds (MP3/Ogg, ≤512 KB, ≤5.2 s). Socialit cannot play sounds (no voice connection). Requires scopes: bot. Network docs: https://docs.discord.com/developers/resources/soundboard Generic route: /v1/accounts/{accountId}/focus/soundboard-sounds.

Access: write

Try it with MCPAsk your agent to call discord-soundboard-sounds-update (toolset focus_discord)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

idstringread-only
namestringrequired

2–32 characters

volumenumberdefault: 1

0–1

emoji_idstring | null
emoji_namestring | null
urlstring (uri)read-only

Responses

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

Discord: Delete a Soundboard item

DELETE/accounts/{accountId}/discord/soundboard-sounds/{itemId}

Server soundboard sounds (MP3/Ogg, ≤512 KB, ≤5.2 s). Socialit cannot play sounds (no voice connection). Requires scopes: bot. Network docs: https://docs.discord.com/developers/resources/soundboard Generic route: /v1/accounts/{accountId}/focus/soundboard-sounds.

Access: write

Try it with MCPAsk your agent to call discord-soundboard-sounds-delete (toolset focus_discord)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}/discord/soundboard-sounds/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/soundboard-sounds/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Commands

Discord: List Socialit commands

GET/accounts/{accountId}/discord/commands

Slash and context-menu commands Socialit registers in this server (≤100 slash, 15 user, 15 message; 200 creates/day). Cursor pagination: pass next_cursor back as cursor. Requires scopes: bot, applications.commands. Network docs: https://docs.discord.com/developers/interactions/application-commands Generic route: /v1/accounts/{accountId}/focus/commands.

Access: read

Try it with MCPAsk your agent to call discord-commands-list (toolset focus_discord)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 9 item attributes
idstringread-only
namestringrequired

1–32 characters

typeinteger

1 slash, 2 user context menu, 3 message context menu

123

type_namestringread-only
descriptionstring

Required for slash commands

≤ 100 characters

optionsarray of object

≤ 25 items

Show 4 item attributes
typeinteger
namestring
descriptionstring
requiredboolean
default_member_permissionsstring | null

Permission bitfield required to see the command

nsfwboolean
versionstringread-only
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}/discord/commands
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/commands" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Discord: Create a Socialit commands item

POST/accounts/{accountId}/discord/commands

Slash and context-menu commands Socialit registers in this server (≤100 slash, 15 user, 15 message; 200 creates/day). Requires scopes: bot, applications.commands. Network docs: https://docs.discord.com/developers/interactions/application-commands Generic route: /v1/accounts/{accountId}/focus/commands.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call discord-commands-create (toolset focus_discord)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

1–32 characters

typeinteger

1 slash, 2 user context menu, 3 message context menu

123

descriptionstring

Required for slash commands

≤ 100 characters

optionsarray of object

≤ 25 items

Show 4 item attributes
typeinteger
namestring
descriptionstring
requiredboolean
default_member_permissionsstring | null

Permission bitfield required to see the command

nsfwboolean

Returns object

idstringread-only
namestringrequired

1–32 characters

typeinteger

1 slash, 2 user context menu, 3 message context menu

123

type_namestringread-only
descriptionstring

Required for slash commands

≤ 100 characters

optionsarray of object

≤ 25 items

Show 4 item attributes
typeinteger
namestring
descriptionstring
requiredboolean
default_member_permissionsstring | null

Permission bitfield required to see the command

nsfwboolean
versionstringread-only

Responses

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

Discord: Get a Socialit commands item

GET/accounts/{accountId}/discord/commands/{itemId}

Slash and context-menu commands Socialit registers in this server (≤100 slash, 15 user, 15 message; 200 creates/day). Requires scopes: bot, applications.commands. Network docs: https://docs.discord.com/developers/interactions/application-commands Generic route: /v1/accounts/{accountId}/focus/commands.

Access: read

Try it with MCPAsk your agent to call discord-commands-get (toolset focus_discord)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

idstringread-only
namestringrequired

1–32 characters

typeinteger

1 slash, 2 user context menu, 3 message context menu

123

type_namestringread-only
descriptionstring

Required for slash commands

≤ 100 characters

optionsarray of object

≤ 25 items

Show 4 item attributes
typeinteger
namestring
descriptionstring
requiredboolean
default_member_permissionsstring | null

Permission bitfield required to see the command

nsfwboolean
versionstringread-only

Responses

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

Discord: Update a Socialit commands item

PATCH/accounts/{accountId}/discord/commands/{itemId}

Slash and context-menu commands Socialit registers in this server (≤100 slash, 15 user, 15 message; 200 creates/day). Requires scopes: bot, applications.commands. Network docs: https://docs.discord.com/developers/interactions/application-commands Generic route: /v1/accounts/{accountId}/focus/commands.

Access: write

Try it with MCPAsk your agent to call discord-commands-update (toolset focus_discord)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

idstringread-only
namestringrequired

1–32 characters

typeinteger

1 slash, 2 user context menu, 3 message context menu

123

type_namestringread-only
descriptionstring

Required for slash commands

≤ 100 characters

optionsarray of object

≤ 25 items

Show 4 item attributes
typeinteger
namestring
descriptionstring
requiredboolean
default_member_permissionsstring | null

Permission bitfield required to see the command

nsfwboolean
versionstringread-only

Responses

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

Discord: Delete a Socialit commands item

DELETE/accounts/{accountId}/discord/commands/{itemId}

Slash and context-menu commands Socialit registers in this server (≤100 slash, 15 user, 15 message; 200 creates/day). Requires scopes: bot, applications.commands. Network docs: https://docs.discord.com/developers/interactions/application-commands Generic route: /v1/accounts/{accountId}/focus/commands.

Access: write

Try it with MCPAsk your agent to call discord-commands-delete (toolset focus_discord)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}/discord/commands/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/commands/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Discord: Reset to Socialit defaults (Socialit commands)

POST/accounts/{accountId}/discord/commands/register-defaults

Bulk-overwrites the server's Socialit commands with: Send to Socialit inbox, socialit. Slash and context-menu commands Socialit registers in this server (≤100 slash, 15 user, 15 message; 200 creates/day). Requires scopes: bot, applications.commands. Network docs: https://docs.discord.com/developers/interactions/application-commands Generic route: /v1/accounts/{accountId}/focus/commands.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call discord-commands-register-defaults (toolset focus_discord)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}/discord/commands/register-defaults
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/commands/register-defaults" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Discord: Permissions (Socialit commands)

POST/accounts/{accountId}/discord/commands/{itemId}/permissions

Per-command role/user/channel permissions (editing them needs a user token with applications.commands.permissions.update). Slash and context-menu commands Socialit registers in this server (≤100 slash, 15 user, 15 message; 200 creates/day). Requires scopes: bot, applications.commands. Network docs: https://docs.discord.com/developers/interactions/application-commands Generic route: /v1/accounts/{accountId}/focus/commands.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call discord-commands-permissions (toolset focus_discord)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}/discord/commands/{itemId}/permissions
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/commands/ITEM_ID/permissions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200