# Focus · Discord API

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

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

## 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` · MCP tool: `discord-server-get`

### Path parameters

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

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

Response 200:

```json
{
  "id": "string",
  "name": "string",
  "description": "string",
  "icon_url": "https://example.com",
  "icon": "string",
  "banner": "string",
  "splash": "string",
  "member_count": 1,
  "online_count": 1,
  "premium_tier": 1,
  "boost_count": 1,
  "features": [
    "string"
  ],
  "verification_level": 0,
  "default_message_notifications": 0,
  "explicit_content_filter": 0,
  "preferred_locale": "string",
  "system_channel_id": "string",
  "rules_channel_id": "string",
  "public_updates_channel_id": "string",
  "safety_alerts_channel_id": "string",
  "afk_channel_id": "string",
  "afk_timeout": 60,
  "premium_progress_bar_enabled": true,
  "vanity_url_code": "string"
}
```

## 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` · MCP tool: `discord-server-update`

### Path parameters

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

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

```json
{
  "id": "string",
  "name": "string",
  "description": "string",
  "icon_url": "https://example.com",
  "icon": "string",
  "banner": "string",
  "splash": "string",
  "member_count": 1,
  "online_count": 1,
  "premium_tier": 1,
  "boost_count": 1,
  "features": [
    "string"
  ],
  "verification_level": 0,
  "default_message_notifications": 0,
  "explicit_content_filter": 0,
  "preferred_locale": "string",
  "system_channel_id": "string",
  "rules_channel_id": "string",
  "public_updates_channel_id": "string",
  "safety_alerts_channel_id": "string",
  "afk_channel_id": "string",
  "afk_timeout": 60,
  "premium_progress_bar_enabled": true,
  "vanity_url_code": "string"
}
```

## 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: `write` · MCP tool: `discord-server-refresh-permissions`

### Path parameters

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

### Headers

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

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

Response 200:

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

## 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: `write` · MCP tool: `discord-server-register-commands`

### Path parameters

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

### Headers

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

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

Response 200:

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

## 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: `write` · MCP tool: `discord-server-pause-invites`

### Path parameters

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

### Headers

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

### Body

- `invites_disabled_until` (string (date-time) | null)
- `dms_disabled_until` (string (date-time) | null)

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

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

## 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` · MCP tool: `discord-server-leave`

### Path parameters

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

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

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

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

### Path parameters

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

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

Response 200:

```json
{
  "mode": "bot",
  "guildId": "string",
  "guildName": "string",
  "channelId": "string",
  "channelName": "string",
  "channelType": 1,
  "webhookUsername": "string",
  "webhookAvatarUrl": "https://example.com"
}
```

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

### Path parameters

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

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

```json
{
  "mode": "bot",
  "guildId": "string",
  "guildName": "string",
  "channelId": "string",
  "channelName": "string",
  "channelType": 1,
  "webhookUsername": "string",
  "webhookAvatarUrl": "https://example.com"
}
```

## 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` · MCP tool: `discord-welcome-screen-get`

### Path parameters

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

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

Response 200:

```json
{
  "enabled": true,
  "description": "string",
  "welcome_channels": [
    {
      "channel_id": "string",
      "description": "string",
      "emoji_id": "string",
      "emoji_name": "string"
    }
  ]
}
```

## 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` · MCP tool: `discord-welcome-screen-update`

### Path parameters

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

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

```json
{
  "enabled": true,
  "description": "string",
  "welcome_channels": [
    {
      "channel_id": "string",
      "description": "string",
      "emoji_id": "string",
      "emoji_name": "string"
    }
  ]
}
```

## 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` · MCP tool: `discord-onboarding-get`

### Path parameters

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

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

Response 200:

```json
{
  "enabled": true,
  "mode": 0,
  "default_channel_ids": [
    "string"
  ],
  "prompts": [
    {
      "id": "string",
      "type": 0,
      "title": "string",
      "single_select": true,
      "required": true,
      "in_onboarding": true,
      "options": [
        {
          "id": "string",
          "title": "string",
          "description": "string",
          "channel_ids": [],
          "role_ids": []
        }
      ]
    }
  ]
}
```

## 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` · MCP tool: `discord-onboarding-update`

### Path parameters

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

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

```json
{
  "enabled": true,
  "mode": 0,
  "default_channel_ids": [
    "string"
  ],
  "prompts": [
    {
      "id": "string",
      "type": 0,
      "title": "string",
      "single_select": true,
      "required": true,
      "in_onboarding": true,
      "options": [
        {
          "id": "string",
          "title": "string",
          "description": "string",
          "channel_ids": [],
          "role_ids": []
        }
      ]
    }
  ]
}
```

## 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` · MCP tool: `discord-widget-get`

### Path parameters

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

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

Response 200:

```json
{
  "enabled": true,
  "channel_id": "string",
  "widget_json_url": "https://example.com"
}
```

## 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` · MCP tool: `discord-widget-update`

### Path parameters

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

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

```json
{
  "enabled": true,
  "channel_id": "string",
  "widget_json_url": "https://example.com"
}
```

## 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` · MCP tool: `discord-bot-persona-get`

### Path parameters

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

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

Response 200:

```json
{
  "nick": "string",
  "avatar": "string",
  "banner": "string",
  "bio": "string",
  "roles": [
    "string"
  ]
}
```

## 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` · MCP tool: `discord-bot-persona-update`

### Path parameters

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

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

```json
{
  "nick": "string",
  "avatar": "string",
  "banner": "string",
  "bio": "string",
  "roles": [
    "string"
  ]
}
```

## 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` · MCP tool: `discord-integrations-list`

### Path parameters

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

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

Response 200:

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

## 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` · MCP tool: `discord-integrations-delete`

### Path parameters

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

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

Response 200:

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

## 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` · MCP tool: `discord-server-stats-get`

### Path parameters

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

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

Response 200:

```json
{
  "followers": 1,
  "online_count": 1,
  "boost_count": 1,
  "boost_tier": 1,
  "roles": [
    {
      "role_id": "string",
      "name": "string",
      "members": 1
    }
  ]
}
```

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

### Path parameters

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

### Query parameters

- `types` (array of integer): Filter by channel type

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "type": 0,
      "type_name": "string",
      "parent_id": "string",
      "position": 1,
      "topic": "string",
      "nsfw": true,
      "rate_limit_per_user": 0,
      "bitrate": 1,
      "user_limit": 1,
      "default_auto_archive_duration": 60,
      "available_tags": [
        {
          "id": "string",
          "name": "string",
          "moderated": true,
          "emoji_name": "string"
        }
      ],
      "permission_overwrites": [
        {
          "id": "string",
          "type": 0,
          "allow": "string",
          "deny": "string"
        }
      ],
      "postable": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

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

### Path parameters

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

### Headers

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

### Body

- `name` (string; required; 1–100 characters)
- `type` (integer; one of 0, 2, 4, 5, 13, 15, 16): 0 text, 2 voice, 4 category, 5 announcement, 13 stage, 15 forum, 16 media
- `parent_id` (string | null): Category id
- `position` (integer)
- `topic` (string | null; ≤ 4096 characters)
- `nsfw` (boolean)
- `rate_limit_per_user` (integer; 0–21600): Slow mode (seconds)
- `bitrate` (integer)
- `user_limit` (integer)
- `default_auto_archive_duration` (integer; one of 60, 1440, 4320, 10080)
- `available_tags` (array of object; ≤ 20 items)
  - `available_tags[].id` (string)
  - `available_tags[].name` (string; ≤ 20 characters)
  - `available_tags[].moderated` (boolean)
  - `available_tags[].emoji_name` (string | null)
- `permission_overwrites` (array of object)
  - `permission_overwrites[].id` (string)
  - `permission_overwrites[].type` (integer; one of 0, 1)
  - `permission_overwrites[].allow` (string)
  - `permission_overwrites[].deny` (string)

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

```json
{
  "id": "string",
  "name": "string",
  "type": 0,
  "type_name": "string",
  "parent_id": "string",
  "position": 1,
  "topic": "string",
  "nsfw": true,
  "rate_limit_per_user": 0,
  "bitrate": 1,
  "user_limit": 1,
  "default_auto_archive_duration": 60,
  "available_tags": [
    {
      "id": "string",
      "name": "string",
      "moderated": true,
      "emoji_name": "string"
    }
  ],
  "permission_overwrites": [
    {
      "id": "string",
      "type": 0,
      "allow": "string",
      "deny": "string"
    }
  ],
  "postable": true
}
```

## 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` · MCP tool: `discord-channels-get`

### Path parameters

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

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

Response 200:

```json
{
  "id": "string",
  "name": "string",
  "type": 0,
  "type_name": "string",
  "parent_id": "string",
  "position": 1,
  "topic": "string",
  "nsfw": true,
  "rate_limit_per_user": 0,
  "bitrate": 1,
  "user_limit": 1,
  "default_auto_archive_duration": 60,
  "available_tags": [
    {
      "id": "string",
      "name": "string",
      "moderated": true,
      "emoji_name": "string"
    }
  ],
  "permission_overwrites": [
    {
      "id": "string",
      "type": 0,
      "allow": "string",
      "deny": "string"
    }
  ],
  "postable": true
}
```

## 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` · MCP tool: `discord-channels-update`

### Path parameters

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

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

```json
{
  "id": "string",
  "name": "string",
  "type": 0,
  "type_name": "string",
  "parent_id": "string",
  "position": 1,
  "topic": "string",
  "nsfw": true,
  "rate_limit_per_user": 0,
  "bitrate": 1,
  "user_limit": 1,
  "default_auto_archive_duration": 60,
  "available_tags": [
    {
      "id": "string",
      "name": "string",
      "moderated": true,
      "emoji_name": "string"
    }
  ],
  "permission_overwrites": [
    {
      "id": "string",
      "type": 0,
      "allow": "string",
      "deny": "string"
    }
  ],
  "postable": true
}
```

## 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` · MCP tool: `discord-channels-delete`

### Path parameters

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

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

Response 200:

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

## 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: `write` · MCP tool: `discord-channels-view-permissions`

### Path parameters

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

### Headers

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

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

Response 200:

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

## 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: `write` · MCP tool: `discord-channels-set-permission`

### Path parameters

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

### Headers

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

### Body

- `overwrite_id` (string; required): Role or member id
- `type` (string; required; one of role, member)
- `allow` (array of string): Permission flag names
- `deny` (array of string)
- `reason` (string; ≤ 512 characters): Shown in the server audit log

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

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

## 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` · MCP tool: `discord-channels-delete-permission`

### Path parameters

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

### Body

- `overwrite_id` (string; required)
- `reason` (string; ≤ 512 characters): Shown in the server audit log

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

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

## 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: `write` · MCP tool: `discord-channels-reorder`

### Path parameters

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

### Headers

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

### Body

- `positions` (array of object; ≥ 1 items)
  - `positions[].id` (string)
  - `positions[].position` (integer)
  - `positions[].parent_id` (string | null)
  - `positions[].lock_permissions` (boolean)

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

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

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

### Path parameters

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

### Headers

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

### Body

- `webhook_channel_id` (string; required): Target channel (in a server Socialit manages)

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

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

## 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: `write` · MCP tool: `discord-channels-create-invite`

### Path parameters

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

### Headers

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

### Body

- `max_age` (integer; 0–604800)
- `max_uses` (integer; 0–100)
- `temporary` (boolean)
- `unique` (boolean)

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

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

## 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` · MCP tool: `discord-threads-list`

### Path parameters

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

### Query parameters

- `channel_id` (string): Parent channel filter
- `archived` (boolean): List archived threads of channel_id
- `private` (boolean)
- `before` (string (date-time))
- `limit` (integer; 1–100)

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "parent_id": "string",
      "type": 10,
      "message_id": "string",
      "archived": true,
      "locked": true,
      "invitable": true,
      "auto_archive_duration": 60,
      "rate_limit_per_user": 0,
      "applied_tags": [
        "string"
      ],
      "message_count": 1,
      "member_count": 1,
      "owner_id": "string",
      "created_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `discord-threads-create` · Zernio: `POST /v1/discord/channels/{channelId}/threads`

### Path parameters

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

### Headers

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

### Body

- `name` (string; required; 1–100 characters)
- `parent_id` (string): Parent channel
- `type` (integer; one of 10, 11, 12): 10 announcement, 11 public, 12 private
- `message_id` (string | null): Start from this message (create)
- `archived` (boolean)
- `locked` (boolean)
- `invitable` (boolean)
- `auto_archive_duration` (integer; one of 60, 1440, 4320, 10080)
- `rate_limit_per_user` (integer; 0–21600)
- `applied_tags` (array of string; ≤ 5 items)

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

```json
{
  "id": "string",
  "name": "string",
  "parent_id": "string",
  "type": 10,
  "message_id": "string",
  "archived": true,
  "locked": true,
  "invitable": true,
  "auto_archive_duration": 60,
  "rate_limit_per_user": 0,
  "applied_tags": [
    "string"
  ],
  "message_count": 1,
  "member_count": 1,
  "owner_id": "string",
  "created_at": "2026-10-13T09:00:00.000Z"
}
```

## 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` · MCP tool: `discord-threads-get`

### Path parameters

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

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

Response 200:

```json
{
  "id": "string",
  "name": "string",
  "parent_id": "string",
  "type": 10,
  "message_id": "string",
  "archived": true,
  "locked": true,
  "invitable": true,
  "auto_archive_duration": 60,
  "rate_limit_per_user": 0,
  "applied_tags": [
    "string"
  ],
  "message_count": 1,
  "member_count": 1,
  "owner_id": "string",
  "created_at": "2026-10-13T09:00:00.000Z"
}
```

## 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` · MCP tool: `discord-threads-update`

### Path parameters

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

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

```json
{
  "id": "string",
  "name": "string",
  "parent_id": "string",
  "type": 10,
  "message_id": "string",
  "archived": true,
  "locked": true,
  "invitable": true,
  "auto_archive_duration": 60,
  "rate_limit_per_user": 0,
  "applied_tags": [
    "string"
  ],
  "message_count": 1,
  "member_count": 1,
  "owner_id": "string",
  "created_at": "2026-10-13T09:00:00.000Z"
}
```

## 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` · MCP tool: `discord-threads-delete`

### Path parameters

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

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

Response 200:

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

## 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: `write` · MCP tool: `discord-threads-join`

### Path parameters

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

### Headers

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

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

Response 200:

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

## 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: `write` · MCP tool: `discord-threads-leave`

### Path parameters

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

### Headers

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

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

Response 200:

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

## 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: `write` · MCP tool: `discord-threads-add-member`

### Path parameters

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

### Headers

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

### Body

- `user_id` (string; required)

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

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

## 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: `write` · MCP tool: `discord-threads-remove-member`

### Path parameters

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

### Headers

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

### Body

- `user_id` (string; required)

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

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

## 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: `write` · MCP tool: `discord-threads-members`

### Path parameters

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

### Headers

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

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

Response 200:

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

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

### Path parameters

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

### Query parameters

- `forum_id` (string)
- `archived` (boolean)
- `before` (string (date-time))
- `limit` (integer; 1–100)

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "forum_id": "string",
      "title": "string",
      "content": "string",
      "media": [
        "string"
      ],
      "applied_tags": [
        "string"
      ],
      "archived": true,
      "locked": true,
      "pinned": true,
      "message_count": 1,
      "created_at": "2026-10-13T09:00:00.000Z",
      "external_id": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

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

### Path parameters

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

### Headers

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

### Body

- `forum_id` (string): Forum or media channel (default: the account channel)
- `title` (string; required; 1–100 characters)
- `content` (string; ≤ 2000 characters): Starter message (create)
- `media` (array of string; ≤ 10 items)
- `applied_tags` (array of string; ≤ 5 items)
- `archived` (boolean)
- `locked` (boolean)
- `pinned` (boolean)

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

```json
{
  "id": "string",
  "forum_id": "string",
  "title": "string",
  "content": "string",
  "media": [
    "string"
  ],
  "applied_tags": [
    "string"
  ],
  "archived": true,
  "locked": true,
  "pinned": true,
  "message_count": 1,
  "created_at": "2026-10-13T09:00:00.000Z",
  "external_id": "string"
}
```

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

### Path parameters

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

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

Response 200:

```json
{
  "id": "string",
  "forum_id": "string",
  "title": "string",
  "content": "string",
  "media": [
    "string"
  ],
  "applied_tags": [
    "string"
  ],
  "archived": true,
  "locked": true,
  "pinned": true,
  "message_count": 1,
  "created_at": "2026-10-13T09:00:00.000Z",
  "external_id": "string"
}
```

## 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` · MCP tool: `discord-forum-posts-update`

### Path parameters

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

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

```json
{
  "id": "string",
  "forum_id": "string",
  "title": "string",
  "content": "string",
  "media": [
    "string"
  ],
  "applied_tags": [
    "string"
  ],
  "archived": true,
  "locked": true,
  "pinned": true,
  "message_count": 1,
  "created_at": "2026-10-13T09:00:00.000Z",
  "external_id": "string"
}
```

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

### Path parameters

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

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

Response 200:

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

## 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: `write` · MCP tool: `discord-forum-posts-set-tags`

### Path parameters

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

### Headers

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

### Body

- `forum_id` (string)
- `available_tags` (array of object; ≤ 20 items)
  - `available_tags[].id` (string | null)
  - `available_tags[].name` (string; ≤ 20 characters)
  - `available_tags[].moderated` (boolean)
  - `available_tags[].emoji_name` (string | null)
  - `available_tags[].emoji_id` (string | null)

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

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

## 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` · MCP tool: `discord-webhooks-list`

### Path parameters

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

### Query parameters

- `channel_id` (string)

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

Response 200:

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

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

### Path parameters

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

### Headers

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

### Body

- `name` (string; required; 1–80 characters)
- `channel_id` (string; required)
- `avatar` (string | null): Avatar image (write)

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

```json
{
  "id": "string",
  "name": "string",
  "channel_id": "string",
  "avatar": "string",
  "type": 1,
  "application_id": "string",
  "owned_by_socialit": true,
  "creator": "string"
}
```

## 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` · MCP tool: `discord-webhooks-get`

### Path parameters

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

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

Response 200:

```json
{
  "id": "string",
  "name": "string",
  "channel_id": "string",
  "avatar": "string",
  "type": 1,
  "application_id": "string",
  "owned_by_socialit": true,
  "creator": "string"
}
```

## 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` · MCP tool: `discord-webhooks-update`

### Path parameters

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

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

```json
{
  "id": "string",
  "name": "string",
  "channel_id": "string",
  "avatar": "string",
  "type": 1,
  "application_id": "string",
  "owned_by_socialit": true,
  "creator": "string"
}
```

## 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` · MCP tool: `discord-webhooks-delete`

### Path parameters

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

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

Response 200:

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

## 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: `write` · MCP tool: `discord-webhooks-send`

### Path parameters

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

### Headers

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

### Body

- `content` (string; required; ≤ 2000 characters)
- `username` (string; ≤ 80 characters)
- `avatar_url` (string (uri))

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

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

## 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` · MCP tool: `discord-stage-instances-list`

### Path parameters

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

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "channel_id": "string",
      "topic": "string",
      "privacy_level": 2,
      "send_start_notification": true,
      "guild_scheduled_event_id": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `discord-stage-instances-create`

### Path parameters

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

### Headers

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

### Body

- `channel_id` (string; required)
- `topic` (string; required; 1–120 characters)
- `send_start_notification` (boolean): Notify @everyone (MENTION_EVERYONE)
- `guild_scheduled_event_id` (string | null)

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

```json
{
  "id": "string",
  "channel_id": "string",
  "topic": "string",
  "privacy_level": 2,
  "send_start_notification": true,
  "guild_scheduled_event_id": "string"
}
```

## 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` · MCP tool: `discord-stage-instances-get`

### Path parameters

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

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

Response 200:

```json
{
  "id": "string",
  "channel_id": "string",
  "topic": "string",
  "privacy_level": 2,
  "send_start_notification": true,
  "guild_scheduled_event_id": "string"
}
```

## 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` · MCP tool: `discord-stage-instances-update`

### Path parameters

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

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

```json
{
  "id": "string",
  "channel_id": "string",
  "topic": "string",
  "privacy_level": 2,
  "send_start_notification": true,
  "guild_scheduled_event_id": "string"
}
```

## 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` · MCP tool: `discord-stage-instances-delete`

### Path parameters

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

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

Response 200:

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

## 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` · MCP tool: `discord-messages-list`

### Path parameters

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

### Query parameters

- `channel_id` (string): Channel or thread (default: the account channel)
- `before` (string)
- `after` (string)
- `around` (string)
- `limit` (integer; 1–100)

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "message_id": "string",
      "channel_id": "string",
      "text": "string",
      "author": "string",
      "author_id": "string",
      "author_avatar_url": "https://example.com",
      "created_at": "2026-10-13T09:00:00.000Z",
      "edited_at": "2026-10-13T09:00:00.000Z",
      "like_count": 1,
      "reactions": [
        {
          "emoji": "string",
          "count": 1,
          "me": true
        }
      ],
      "reply_to_id": "string",
      "attachments": [
        {
          "id": "string",
          "url": "https://example.com",
          "filename": "string",
          "content_type": "string"
        }
      ],
      "embeds": [
        {}
      ],
      "content_restricted": true,
      "url": "https://example.com"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `discord-messages-create` · Zernio: `POST /v1/discord/channels/{channelId}/messages/{messageId}/crosspost`

### Path parameters

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

### Headers

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

### Body

- `channel_id` (string): Default: the account channel
- `text` (string; ≤ 2000 characters)
- `media` (array of string; ≤ 10 items)
- `reply_to_id` (string): channel:message to reply to
- `options` (object): Same options as platform_options.discord
  - `options.channelId` (string): Target channel snowflake (default: the account channel). Must be in the connected server.
  - `options.threadId` (string): Post into an existing thread / forum post instead of the channel.
  - `options.embeds` (array of object; ≤ 10 items): Rich embeds; ≤6,000 chars combined.
    - `options.embeds[].title` (string; ≤ 256 characters)
    - `options.embeds[].description` (string; ≤ 4096 characters)
    - `options.embeds[].url` (string (uri))
    - `options.embeds[].color` (integer | string): Decimal or #RRGGBB
    - `options.embeds[].timestamp` (string (date-time))
    - `options.embeds[].image` (object)
      - `options.embeds[].image.url` (string)
    - `options.embeds[].thumbnail` (object)
      - `options.embeds[].thumbnail.url` (string)
    - `options.embeds[].footer` (object)
      - `options.embeds[].footer.text` (string; ≤ 2048 characters)
      - `options.embeds[].footer.icon_url` (string)
    - `options.embeds[].author` (object)
      - `options.embeds[].author.name` (string; ≤ 256 characters)
      - `options.embeds[].author.url` (string)
      - `options.embeds[].author.icon_url` (string)
    - `options.embeds[].fields` (array of object; ≤ 25 items)
      - `options.embeds[].fields[].name` (string; required; ≤ 256 characters)
      - `options.embeds[].fields[].value` (string; required; ≤ 1024 characters)
      - `options.embeds[].fields[].inline` (boolean)
  - `options.poll` (object): Native poll (cannot be edited; no attachments). Discord shape or { question: string, options: string[], durationHours, multiselect }.
    - `options.poll.question` (string | object)
      - one of: Option 1 (string)
      - one of: Option 2 (object)
        - `options.poll.question.text` (string; ≤ 300 characters)
    - `options.poll.answers` (array of any; 1–10 items)
    - `options.poll.options` (array of string; 1–10 items)
    - `options.poll.duration` (integer; 1–768)
    - `options.poll.durationHours` (integer; 1–768)
    - `options.poll.allow_multiselect` (boolean)
    - `options.poll.multiselect` (boolean)
  - `options.crosspost` (boolean): Publish to followers when the channel is an announcement channel (10/hour/channel).
  - `options.forumThreadName` (string; ≤ 100 characters): Forum/media post title (required for forum channels; defaults to the first line).
  - `options.forumAppliedTags` (array of string; ≤ 5 items): Forum tag ids.
  - `options.autoArchiveDuration` (integer; one of 60, 1440, 4320, 10080): Forum post auto-archive (minutes).
  - `options.rateLimitPerUser` (integer; 0–21600): Forum post slow mode (seconds).
  - `options.threadFromMessage` (object): Open a public thread under the published message.
    - `options.threadFromMessage.name` (string; 1–100 characters)
    - `options.threadFromMessage.autoArchiveDuration` (integer; one of 60, 1440, 4320, 10080)
    - `options.threadFromMessage.rateLimitPerUser` (integer; 0–21600)
  - `options.tts` (boolean)
  - `options.silent` (boolean): SUPPRESS_NOTIFICATIONS flag.
  - `options.suppressEmbeds` (boolean): Hide link previews.
  - `options.mentions` (string; one of none, users, roles, everyone): Which mentions in the content ping (default none; "everyone" needs MENTION_EVERYONE).
  - `options.allowedMentions` (object): Raw Discord allowed_mentions (overrides mentions).
  - `options.buttons` (array of object; ≤ 25 items): Link buttons (rendered as action rows of up to 5).
    - `options.buttons[].label` (string; required; ≤ 80 characters)
    - `options.buttons[].url` (string (uri); required)
    - `options.buttons[].emoji` (string)
  - `options.components` (array of any): Raw message components (action rows or Components V2 layout).
  - `options.componentsV2` (boolean): Send components as a Components V2 layout (IS_COMPONENTS_V2; content/embeds/poll disabled; irreversible).
  - `options.stickerIds` (array of string; ≤ 3 items)
  - `options.pin` (boolean): Pin the message after publishing (PIN_MESSAGES).
  - `options.webhookUsername` (string; 1–80 characters): Per-post display name (may not contain "clyde"/"discord").
  - `options.webhookAvatarUrl` (string (uri)): Per-post avatar URL.
  - `options.nonce` (string; ≤ 25 characters): Idempotency nonce (enforce_nonce).

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

```json
{
  "id": "string",
  "message_id": "string",
  "channel_id": "string",
  "text": "string",
  "author": "string",
  "author_id": "string",
  "author_avatar_url": "https://example.com",
  "created_at": "2026-10-13T09:00:00.000Z",
  "edited_at": "2026-10-13T09:00:00.000Z",
  "like_count": 1,
  "reactions": [
    {
      "emoji": "string",
      "count": 1,
      "me": true
    }
  ],
  "reply_to_id": "string",
  "attachments": [
    {
      "id": "string",
      "url": "https://example.com",
      "filename": "string",
      "content_type": "string"
    }
  ],
  "embeds": [
    {}
  ],
  "content_restricted": true,
  "url": "https://example.com"
}
```

## 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` · MCP tool: `discord-messages-get`

### Path parameters

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

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

Response 200:

```json
{
  "id": "string",
  "message_id": "string",
  "channel_id": "string",
  "text": "string",
  "author": "string",
  "author_id": "string",
  "author_avatar_url": "https://example.com",
  "created_at": "2026-10-13T09:00:00.000Z",
  "edited_at": "2026-10-13T09:00:00.000Z",
  "like_count": 1,
  "reactions": [
    {
      "emoji": "string",
      "count": 1,
      "me": true
    }
  ],
  "reply_to_id": "string",
  "attachments": [
    {
      "id": "string",
      "url": "https://example.com",
      "filename": "string",
      "content_type": "string"
    }
  ],
  "embeds": [
    {}
  ],
  "content_restricted": true,
  "url": "https://example.com"
}
```

## 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` · MCP tool: `discord-messages-update`

### Path parameters

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

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

```json
{
  "id": "string",
  "message_id": "string",
  "channel_id": "string",
  "text": "string",
  "author": "string",
  "author_id": "string",
  "author_avatar_url": "https://example.com",
  "created_at": "2026-10-13T09:00:00.000Z",
  "edited_at": "2026-10-13T09:00:00.000Z",
  "like_count": 1,
  "reactions": [
    {
      "emoji": "string",
      "count": 1,
      "me": true
    }
  ],
  "reply_to_id": "string",
  "attachments": [
    {
      "id": "string",
      "url": "https://example.com",
      "filename": "string",
      "content_type": "string"
    }
  ],
  "embeds": [
    {}
  ],
  "content_restricted": true,
  "url": "https://example.com"
}
```

## 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: `write` · MCP tool: `discord-messages-delete` · Zernio: `DELETE /v1/discord/channels/{channelId}/messages/{messageId}`

### Path parameters

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

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

Response 200:

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

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

### Path parameters

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

### Headers

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

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

Response 200:

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

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

### Path parameters

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

### Headers

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

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

Response 200:

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

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

### Path parameters

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

### Headers

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

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

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

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

### Path parameters

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

### Headers

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

### Body

- `emoji` (string; required): Unicode emoji or name:id

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

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

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

### Path parameters

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

### Headers

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

### Body

- `emoji` (string; required)

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

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

## 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` · MCP tool: `discord-messages-clear-reactions`

### Path parameters

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

### Body

- `emoji` (string): Only this emoji (optional)

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

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

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

### Path parameters

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

### Headers

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

### Body

- `emoji` (string; required)
- `type` (integer; one of 0, 1): 0 normal, 1 super
- `after` (string)
- `limit` (integer; ≤ 100)

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

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

## 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: `write` · MCP tool: `discord-messages-create-thread`

### Path parameters

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

### Headers

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

### Body

- `name` (string; required; ≤ 100 characters)
- `auto_archive_duration` (integer; one of 60, 1440, 4320, 10080)

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

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

## 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: `write` · MCP tool: `discord-messages-end-poll`

### Path parameters

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

### Headers

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

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

Response 200:

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

## 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: `write` · MCP tool: `discord-messages-poll-voters`

### Path parameters

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

### Headers

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

### Body

- `answer_id` (integer; required)
- `after` (string)
- `limit` (integer; ≤ 100)

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

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

## Discord: Search messages (Messages)

`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: `write` · MCP tool: `discord-messages-search`

### Path parameters

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

### Headers

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

### Body

- `content` (string)
- `author_id` (string)
- `channel_id` (string)
- `mentions` (string)
- `has` (string; one of link, embed, file, poll, image, video, sound, sticker, snapshot)
- `pinned` (boolean)
- `limit` (integer; 1–25)
- `offset` (integer; 0–9975)

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

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

## 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` · MCP tool: `discord-messages-bulk-delete`

### Path parameters

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

### Body

- `channel_id` (string)
- `message_ids` (array of string; required; 2–100 items)
- `reason` (string; ≤ 512 characters): Shown in the server audit log

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

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

## 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: `read` · MCP tool: `discord-pins-list` · Zernio: `GET /v1/discord/channels/{channelId}/pins`

### Path parameters

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

### Query parameters

- `channel_id` (string)
- `before` (string (date-time))

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "message_id": "string",
      "channel_id": "string",
      "text": "string",
      "author": "string",
      "author_id": "string",
      "author_avatar_url": "https://example.com",
      "created_at": "2026-10-13T09:00:00.000Z",
      "edited_at": "2026-10-13T09:00:00.000Z",
      "like_count": 1,
      "reactions": [
        {
          "emoji": "string",
          "count": 1,
          "me": true
        }
      ],
      "reply_to_id": "string",
      "attachments": [
        {
          "id": "string",
          "url": "https://example.com",
          "filename": "string",
          "content_type": "string"
        }
      ],
      "embeds": [
        {}
      ],
      "content_restricted": true,
      "url": "https://example.com",
      "pinned_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `discord-pins-create` · Zernio: `PUT /v1/discord/channels/{channelId}/pins/{messageId}`

### Path parameters

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

### Headers

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

### Body

- `message_id` (string; required): channel:message or message id
- `channel_id` (string)

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

```json
{
  "id": "string",
  "message_id": "string",
  "channel_id": "string",
  "text": "string",
  "author": "string",
  "author_id": "string",
  "author_avatar_url": "https://example.com",
  "created_at": "2026-10-13T09:00:00.000Z",
  "edited_at": "2026-10-13T09:00:00.000Z",
  "like_count": 1,
  "reactions": [
    {
      "emoji": "string",
      "count": 1,
      "me": true
    }
  ],
  "reply_to_id": "string",
  "attachments": [
    {
      "id": "string",
      "url": "https://example.com",
      "filename": "string",
      "content_type": "string"
    }
  ],
  "embeds": [
    {}
  ],
  "content_restricted": true,
  "url": "https://example.com",
  "pinned_at": "2026-10-13T09:00:00.000Z"
}
```

## 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: `write` · MCP tool: `discord-pins-delete` · Zernio: `DELETE /v1/discord/channels/{channelId}/pins/{messageId}`

### Path parameters

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

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

Response 200:

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

## 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: `write` · MCP tool: `discord-direct-messages-create` · Zernio: `POST /v1/discord/dms`

### Path parameters

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

### Headers

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

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

Response 201:

```json
{
  "userId": "string",
  "content": "string",
  "embeds": [
    {}
  ],
  "attachments": [
    {
      "url": "https://example.com",
      "type": "image",
      "filename": "string",
      "mimeType": "string"
    }
  ],
  "tts": true
}
```

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

### Path parameters

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

### Query parameters

- `channel_id` (string)
- `limit` (integer; 1–50)
- `only_socialit` (boolean)

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "text": "string",
      "likes": 1,
      "comments": 1,
      "reactions": [
        {
          "emoji": "string",
          "count": 1
        }
      ],
      "poll": {}
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `read` · MCP tool: `discord-members-list` · Zernio: `GET /v1/discord/guilds/{guildId}/members`, `GET /v1/discord/guilds/{guildId}/members/search`

### Path parameters

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

### Query parameters

- `limit` (integer; 1–1000)
- `after` (string)
- `query` (string): Prefix search instead of listing

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "username": "string",
      "global_name": "string",
      "nick": "string",
      "display_name": "string",
      "bot": true,
      "roles": [
        "string"
      ],
      "joined_at": "2026-10-13T09:00:00.000Z",
      "premium_since": "2026-10-13T09:00:00.000Z",
      "pending": true,
      "communication_disabled_until": "2026-10-13T09:00:00.000Z"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `read` · MCP tool: `discord-members-get` · Zernio: `GET /v1/discord/guilds/{guildId}/members/{userId}`

### Path parameters

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

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

Response 200:

```json
{
  "id": "string",
  "username": "string",
  "global_name": "string",
  "nick": "string",
  "display_name": "string",
  "bot": true,
  "roles": [
    "string"
  ],
  "joined_at": "2026-10-13T09:00:00.000Z",
  "premium_since": "2026-10-13T09:00:00.000Z",
  "pending": true,
  "communication_disabled_until": "2026-10-13T09:00:00.000Z"
}
```

## 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: `write` · MCP tool: `discord-members-update` · Zernio: `PUT /v1/discord/guilds/{guildId}/members/{userId}/roles/{roleId}`

### Path parameters

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

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

```json
{
  "id": "string",
  "username": "string",
  "global_name": "string",
  "nick": "string",
  "display_name": "string",
  "bot": true,
  "roles": [
    "string"
  ],
  "joined_at": "2026-10-13T09:00:00.000Z",
  "premium_since": "2026-10-13T09:00:00.000Z",
  "pending": true,
  "communication_disabled_until": "2026-10-13T09:00:00.000Z"
}
```

## 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: `write` · MCP tool: `discord-members-delete` · Zernio: `DELETE /v1/discord/guilds/{guildId}/members/{userId}/roles/{roleId}`

### Path parameters

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

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

Response 200:

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

## Discord: Search (Members)

`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: `write` · MCP tool: `discord-members-search`

### Path parameters

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

### Headers

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

### Body

- `query` (string; required)
- `limit` (integer; 1–1000)

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

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

## 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: `write` · MCP tool: `discord-members-add-role`

### Path parameters

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

### Headers

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

### Body

- `role_id` (string; required)
- `reason` (string; ≤ 512 characters): Shown in the server audit log

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

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

## 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: `write` · MCP tool: `discord-members-remove-role`

### Path parameters

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

### Headers

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

### Body

- `role_id` (string; required)
- `reason` (string; ≤ 512 characters): Shown in the server audit log

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

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

## 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: `write` · MCP tool: `discord-members-timeout`

### Path parameters

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

### Headers

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

### Body

- `duration_seconds` (integer; 60–2419200)
- `until` (string (date-time))
- `reason` (string; ≤ 512 characters): Shown in the server audit log

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

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

## 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: `write` · MCP tool: `discord-members-remove-timeout`

### Path parameters

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

### Headers

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

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

Response 200:

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

## 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` · MCP tool: `discord-members-kick`

### Path parameters

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

### Body

- `reason` (string; ≤ 512 characters): Shown in the server audit log

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

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

## 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` · MCP tool: `discord-members-ban`

### Path parameters

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

### Body

- `delete_message_seconds` (integer; 0–604800)
- `reason` (string; ≤ 512 characters): Shown in the server audit log

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

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

## 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: `write` · MCP tool: `discord-members-prune-count`

### Path parameters

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

### Headers

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

### Body

- `days` (integer; 1–30)
- `include_roles` (array of string)

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

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

## 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` · MCP tool: `discord-members-prune`

### Path parameters

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

### Body

- `days` (integer; required; 1–30)
- `include_roles` (array of string)
- `reason` (string; ≤ 512 characters): Shown in the server audit log

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

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

## 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: `read` · MCP tool: `discord-roles-list` · Zernio: `GET /v1/discord/guilds/{guildId}/roles`

### Path parameters

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

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "color": 1,
      "colors": {
        "primary_color": 1,
        "secondary_color": 1,
        "tertiary_color": 1
      },
      "position": 1,
      "permissions": "string",
      "permission_names": [
        "string"
      ],
      "managed": true,
      "mentionable": true,
      "hoist": true,
      "unicode_emoji": "string",
      "member_count": 1
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `discord-roles-create` · Zernio: `POST /v1/discord/guilds/{guildId}/roles`

### Path parameters

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

### Headers

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

### Body

- `name` (string; required; ≤ 100 characters)
- `color` (integer): Primary color (decimal)
- `colors` (object | null)
  - `colors.primary_color` (integer)
  - `colors.secondary_color` (integer | null)
  - `colors.tertiary_color` (integer | null)
- `permissions` (string): Permission bitfield (string) or array of flag names on write
- `mentionable` (boolean)
- `hoist` (boolean): Show separately in the member list
- `unicode_emoji` (string | null)

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

```json
{
  "id": "string",
  "name": "string",
  "color": 1,
  "colors": {
    "primary_color": 1,
    "secondary_color": 1,
    "tertiary_color": 1
  },
  "position": 1,
  "permissions": "string",
  "permission_names": [
    "string"
  ],
  "managed": true,
  "mentionable": true,
  "hoist": true,
  "unicode_emoji": "string",
  "member_count": 1
}
```

## 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` · MCP tool: `discord-roles-get`

### Path parameters

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

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

Response 200:

```json
{
  "id": "string",
  "name": "string",
  "color": 1,
  "colors": {
    "primary_color": 1,
    "secondary_color": 1,
    "tertiary_color": 1
  },
  "position": 1,
  "permissions": "string",
  "permission_names": [
    "string"
  ],
  "managed": true,
  "mentionable": true,
  "hoist": true,
  "unicode_emoji": "string",
  "member_count": 1
}
```

## 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: `write` · MCP tool: `discord-roles-update` · Zernio: `PATCH /v1/discord/guilds/{guildId}/roles/{roleId}`

### Path parameters

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

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

```json
{
  "id": "string",
  "name": "string",
  "color": 1,
  "colors": {
    "primary_color": 1,
    "secondary_color": 1,
    "tertiary_color": 1
  },
  "position": 1,
  "permissions": "string",
  "permission_names": [
    "string"
  ],
  "managed": true,
  "mentionable": true,
  "hoist": true,
  "unicode_emoji": "string",
  "member_count": 1
}
```

## 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: `write` · MCP tool: `discord-roles-delete` · Zernio: `DELETE /v1/discord/guilds/{guildId}/roles/{roleId}`

### Path parameters

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

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

Response 200:

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

## 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: `write` · MCP tool: `discord-roles-reorder`

### Path parameters

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

### Headers

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

### Body

- `positions` (array of object; required; ≥ 1 items)
  - `positions[].id` (string)
  - `positions[].position` (integer)

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

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

## 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` · MCP tool: `discord-bans-list`

### Path parameters

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

### Query parameters

- `limit` (integer; 1–1000)
- `after` (string)
- `before` (string)

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

Response 200:

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

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

### Path parameters

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

### Headers

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

### Body

- `id` (string; required): User id
- `reason` (string | null; ≤ 512 characters)
- `delete_message_seconds` (integer; 0–604800)

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

```json
{
  "id": "string",
  "username": "string",
  "global_name": "string",
  "reason": "string"
}
```

## 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` · MCP tool: `discord-bans-get`

### Path parameters

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

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

Response 200:

```json
{
  "id": "string",
  "username": "string",
  "global_name": "string",
  "reason": "string"
}
```

## 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` · MCP tool: `discord-bans-delete`

### Path parameters

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

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

Response 200:

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

## 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` · MCP tool: `discord-bans-bulk-ban`

### Path parameters

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

### Body

- `user_ids` (array of string; required; 1–200 items)
- `delete_message_seconds` (integer; 0–604800)
- `reason` (string; ≤ 512 characters): Shown in the server audit log

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

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

## 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` · MCP tool: `discord-invites-list`

### Path parameters

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

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "code": "string",
      "url": "https://example.com",
      "channel_id": "string",
      "inviter": "string",
      "uses": 1,
      "max_uses": 0,
      "max_age": 0,
      "temporary": true,
      "unique": true,
      "role_ids": [
        "string"
      ],
      "created_at": "2026-10-13T09:00:00.000Z",
      "expires_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

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

### Path parameters

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

### Headers

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

### Body

- `channel_id` (string)
- `max_uses` (integer; 0–100)
- `max_age` (integer; 0–604800): Seconds; 0 = never expires
- `temporary` (boolean): Kick when they disconnect unless given a role
- `unique` (boolean)
- `role_ids` (array of string): Roles granted on join (MANAGE_ROLES)

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

```json
{
  "code": "string",
  "url": "https://example.com",
  "channel_id": "string",
  "inviter": "string",
  "uses": 1,
  "max_uses": 0,
  "max_age": 0,
  "temporary": true,
  "unique": true,
  "role_ids": [
    "string"
  ],
  "created_at": "2026-10-13T09:00:00.000Z",
  "expires_at": "2026-10-13T09:00:00.000Z"
}
```

## 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` · MCP tool: `discord-invites-get`

### Path parameters

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

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

Response 200:

```json
{
  "code": "string",
  "url": "https://example.com",
  "channel_id": "string",
  "inviter": "string",
  "uses": 1,
  "max_uses": 0,
  "max_age": 0,
  "temporary": true,
  "unique": true,
  "role_ids": [
    "string"
  ],
  "created_at": "2026-10-13T09:00:00.000Z",
  "expires_at": "2026-10-13T09:00:00.000Z"
}
```

## 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` · MCP tool: `discord-invites-delete`

### Path parameters

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

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

Response 200:

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

## 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: `write` · MCP tool: `discord-invites-vanity`

### Path parameters

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

### Headers

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

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

Response 200:

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

## 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: `read` · MCP tool: `discord-scheduled-events-list` · Zernio: `GET /v1/discord/guilds/{guildId}/events`

### Path parameters

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

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "description": "string",
      "starts_at": "2026-10-13T09:00:00.000Z",
      "ends_at": "2026-10-13T09:00:00.000Z",
      "status": "scheduled",
      "entity_type": "external",
      "channel_id": "string",
      "location": "string",
      "user_count": 1,
      "image": "string",
      "recurrence_rule": {
        "start": "2026-10-13T09:00:00.000Z",
        "frequency": 0,
        "interval": 1,
        "by_weekday": [
          1
        ],
        "by_n_weekday": [
          {
            "n": null,
            "day": null
          }
        ],
        "by_month": [
          1
        ]
      }
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `discord-scheduled-events-create` · Zernio: `POST /v1/discord/guilds/{guildId}/events`

### Path parameters

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

### Headers

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

### Body

- `name` (string; required; ≤ 100 characters)
- `description` (string | null; ≤ 1000 characters)
- `starts_at` (string (date-time); required)
- `ends_at` (string (date-time) | null)
- `status` (string; one of scheduled, active, completed, cancelled)
- `entity_type` (string; required; one of external, voice, stage)
- `channel_id` (string | null)
- `location` (string | null; ≤ 100 characters)
- `image` (string | null)
- `recurrence_rule` (object | null)
  - `recurrence_rule.start` (string (date-time))
  - `recurrence_rule.frequency` (integer; one of 0, 1, 2, 3): 0 yearly, 1 monthly, 2 weekly, 3 daily
  - `recurrence_rule.interval` (integer)
  - `recurrence_rule.by_weekday` (array of integer | null)
  - `recurrence_rule.by_n_weekday` (array of object | null)
    - `recurrence_rule.by_n_weekday[].n` (integer)
    - `recurrence_rule.by_n_weekday[].day` (integer)
  - `recurrence_rule.by_month` (array of integer | null)
  - `recurrence_rule.by_month_day` (array of integer | null)

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

```json
{
  "id": "string",
  "name": "string",
  "description": "string",
  "starts_at": "2026-10-13T09:00:00.000Z",
  "ends_at": "2026-10-13T09:00:00.000Z",
  "status": "scheduled",
  "entity_type": "external",
  "channel_id": "string",
  "location": "string",
  "user_count": 1,
  "image": "string",
  "recurrence_rule": {
    "start": "2026-10-13T09:00:00.000Z",
    "frequency": 0,
    "interval": 1,
    "by_weekday": [
      1
    ],
    "by_n_weekday": [
      {
        "n": 1,
        "day": 1
      }
    ],
    "by_month": [
      1
    ],
    "by_month_day": [
      1
    ]
  }
}
```

## 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: `read` · MCP tool: `discord-scheduled-events-get` · Zernio: `GET /v1/discord/guilds/{guildId}/events/{eventId}`

### Path parameters

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

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

Response 200:

```json
{
  "id": "string",
  "name": "string",
  "description": "string",
  "starts_at": "2026-10-13T09:00:00.000Z",
  "ends_at": "2026-10-13T09:00:00.000Z",
  "status": "scheduled",
  "entity_type": "external",
  "channel_id": "string",
  "location": "string",
  "user_count": 1,
  "image": "string",
  "recurrence_rule": {
    "start": "2026-10-13T09:00:00.000Z",
    "frequency": 0,
    "interval": 1,
    "by_weekday": [
      1
    ],
    "by_n_weekday": [
      {
        "n": 1,
        "day": 1
      }
    ],
    "by_month": [
      1
    ],
    "by_month_day": [
      1
    ]
  }
}
```

## 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: `write` · MCP tool: `discord-scheduled-events-update` · Zernio: `PATCH /v1/discord/guilds/{guildId}/events/{eventId}`

### Path parameters

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

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

```json
{
  "id": "string",
  "name": "string",
  "description": "string",
  "starts_at": "2026-10-13T09:00:00.000Z",
  "ends_at": "2026-10-13T09:00:00.000Z",
  "status": "scheduled",
  "entity_type": "external",
  "channel_id": "string",
  "location": "string",
  "user_count": 1,
  "image": "string",
  "recurrence_rule": {
    "start": "2026-10-13T09:00:00.000Z",
    "frequency": 0,
    "interval": 1,
    "by_weekday": [
      1
    ],
    "by_n_weekday": [
      {
        "n": 1,
        "day": 1
      }
    ],
    "by_month": [
      1
    ],
    "by_month_day": [
      1
    ]
  }
}
```

## 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: `write` · MCP tool: `discord-scheduled-events-delete` · Zernio: `DELETE /v1/discord/guilds/{guildId}/events/{eventId}`

### Path parameters

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

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

Response 200:

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

## 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: `write` · MCP tool: `discord-scheduled-events-users`

### Path parameters

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

### Headers

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

### Body

- `limit` (integer; ≤ 100)
- `after` (string)

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

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

## 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: `write` · MCP tool: `discord-scheduled-events-start`

### Path parameters

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

### Headers

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

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

Response 200:

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

## 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: `write` · MCP tool: `discord-scheduled-events-end`

### Path parameters

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

### Headers

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

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

Response 200:

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

## 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` · MCP tool: `discord-scheduled-events-cancel`

### Path parameters

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

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/discord/scheduled-events/ITEM_ID/cancel" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

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

## 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` · MCP tool: `discord-automod-rules-list`

### Path parameters

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

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "event_type": 1,
      "trigger_type": 1,
      "trigger_type_name": "string",
      "trigger_metadata": {
        "keyword_filter": [
          "string"
        ],
        "regex_patterns": [
          "string"
        ],
        "presets": [
          1
        ],
        "allow_list": [
          "string"
        ],
        "mention_total_limit": 1,
        "mention_raid_protection_enabled": true
      },
      "actions": [
        {
          "type": 1,
          "metadata": {
            "channel_id": null,
            "duration_seconds": null,
            "custom_message": null
          }
        }
      ],
      "enabled": true,
      "exempt_roles": [
        "string"
      ],
      "exempt_channels": [
        "string"
      ]
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `discord-automod-rules-create`

### Path parameters

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

### Headers

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

### Body

- `name` (string; required; ≤ 100 characters)
- `event_type` (integer; required; one of 1, 2): 1 message send, 2 member update
- `trigger_type` (integer; required; one of 1, 3, 4, 5, 6): 1 keyword (≤6 rules), 3 spam, 4 keyword preset, 5 mention spam, 6 member profile
- `trigger_metadata` (object)
  - `trigger_metadata.keyword_filter` (array of string; ≤ 1000 items)
  - `trigger_metadata.regex_patterns` (array of string; ≤ 10 items)
  - `trigger_metadata.presets` (array of integer): 1 profanity, 2 sexual content, 3 slurs
  - `trigger_metadata.allow_list` (array of string; ≤ 1000 items)
  - `trigger_metadata.mention_total_limit` (integer; ≤ 50)
  - `trigger_metadata.mention_raid_protection_enabled` (boolean)
- `actions` (array of object; required; ≥ 1 items)
  - `actions[].type` (integer; one of 1, 2, 3, 4)
  - `actions[].metadata` (object)
    - `actions[].metadata.channel_id` (string)
    - `actions[].metadata.duration_seconds` (integer; ≤ 2419200)
    - `actions[].metadata.custom_message` (string; ≤ 150 characters)
- `enabled` (boolean)
- `exempt_roles` (array of string; ≤ 20 items)
- `exempt_channels` (array of string; ≤ 50 items)

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

```json
{
  "id": "string",
  "name": "string",
  "event_type": 1,
  "trigger_type": 1,
  "trigger_type_name": "string",
  "trigger_metadata": {
    "keyword_filter": [
      "string"
    ],
    "regex_patterns": [
      "string"
    ],
    "presets": [
      1
    ],
    "allow_list": [
      "string"
    ],
    "mention_total_limit": 1,
    "mention_raid_protection_enabled": true
  },
  "actions": [
    {
      "type": 1,
      "metadata": {
        "channel_id": "string",
        "duration_seconds": 1,
        "custom_message": "string"
      }
    }
  ],
  "enabled": true,
  "exempt_roles": [
    "string"
  ],
  "exempt_channels": [
    "string"
  ]
}
```

## 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` · MCP tool: `discord-automod-rules-get`

### Path parameters

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

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

Response 200:

```json
{
  "id": "string",
  "name": "string",
  "event_type": 1,
  "trigger_type": 1,
  "trigger_type_name": "string",
  "trigger_metadata": {
    "keyword_filter": [
      "string"
    ],
    "regex_patterns": [
      "string"
    ],
    "presets": [
      1
    ],
    "allow_list": [
      "string"
    ],
    "mention_total_limit": 1,
    "mention_raid_protection_enabled": true
  },
  "actions": [
    {
      "type": 1,
      "metadata": {
        "channel_id": "string",
        "duration_seconds": 1,
        "custom_message": "string"
      }
    }
  ],
  "enabled": true,
  "exempt_roles": [
    "string"
  ],
  "exempt_channels": [
    "string"
  ]
}
```

## 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` · MCP tool: `discord-automod-rules-update`

### Path parameters

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

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

```json
{
  "id": "string",
  "name": "string",
  "event_type": 1,
  "trigger_type": 1,
  "trigger_type_name": "string",
  "trigger_metadata": {
    "keyword_filter": [
      "string"
    ],
    "regex_patterns": [
      "string"
    ],
    "presets": [
      1
    ],
    "allow_list": [
      "string"
    ],
    "mention_total_limit": 1,
    "mention_raid_protection_enabled": true
  },
  "actions": [
    {
      "type": 1,
      "metadata": {
        "channel_id": "string",
        "duration_seconds": 1,
        "custom_message": "string"
      }
    }
  ],
  "enabled": true,
  "exempt_roles": [
    "string"
  ],
  "exempt_channels": [
    "string"
  ]
}
```

## 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` · MCP tool: `discord-automod-rules-delete`

### Path parameters

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

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

Response 200:

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

## 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` · MCP tool: `discord-audit-log-list`

### Path parameters

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

### Query parameters

- `user_id` (string)
- `action_type` (integer)
- `before` (string)
- `after` (string)
- `limit` (integer; 1–100)

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "user_id": "string",
      "user": "string",
      "action_type": 1,
      "target_id": "string",
      "reason": "string",
      "changes": [
        {
          "key": "string",
          "old_value": null,
          "new_value": null
        }
      ],
      "options": {}
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `discord-emojis-list`

### Path parameters

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

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

Response 200:

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

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

### Path parameters

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

### Headers

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

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

```json
{
  "id": "string",
  "name": "string",
  "roles": [
    "string"
  ],
  "animated": true,
  "url": "https://example.com",
  "markdown": "string",
  "creator": "string"
}
```

## 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` · MCP tool: `discord-emojis-get`

### Path parameters

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

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

Response 200:

```json
{
  "id": "string",
  "name": "string",
  "roles": [
    "string"
  ],
  "animated": true,
  "url": "https://example.com",
  "markdown": "string",
  "creator": "string"
}
```

## 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` · MCP tool: `discord-emojis-update`

### Path parameters

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

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

```json
{
  "id": "string",
  "name": "string",
  "roles": [
    "string"
  ],
  "animated": true,
  "url": "https://example.com",
  "markdown": "string",
  "creator": "string"
}
```

## 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` · MCP tool: `discord-emojis-delete`

### Path parameters

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

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

Response 200:

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

## 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` · MCP tool: `discord-stickers-list`

### Path parameters

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

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

Response 200:

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

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

### Path parameters

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

### Headers

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

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

```json
{
  "id": "string",
  "name": "string",
  "description": "string",
  "tags": "string",
  "format": "string",
  "url": "https://example.com"
}
```

## 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` · MCP tool: `discord-stickers-get`

### Path parameters

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

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

Response 200:

```json
{
  "id": "string",
  "name": "string",
  "description": "string",
  "tags": "string",
  "format": "string",
  "url": "https://example.com"
}
```

## 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` · MCP tool: `discord-stickers-update`

### Path parameters

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

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

```json
{
  "id": "string",
  "name": "string",
  "description": "string",
  "tags": "string",
  "format": "string",
  "url": "https://example.com"
}
```

## 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` · MCP tool: `discord-stickers-delete`

### Path parameters

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

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

Response 200:

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

## 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` · MCP tool: `discord-soundboard-sounds-list`

### Path parameters

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

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

Response 200:

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

## 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: `write` · MCP tool: `discord-soundboard-sounds-create`

### Path parameters

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

### Headers

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

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

```json
{
  "id": "string",
  "name": "string",
  "volume": 1,
  "emoji_id": "string",
  "emoji_name": "string",
  "url": "https://example.com"
}
```

## 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` · MCP tool: `discord-soundboard-sounds-get`

### Path parameters

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

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

Response 200:

```json
{
  "id": "string",
  "name": "string",
  "volume": 1,
  "emoji_id": "string",
  "emoji_name": "string",
  "url": "https://example.com"
}
```

## 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` · MCP tool: `discord-soundboard-sounds-update`

### Path parameters

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

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

```json
{
  "id": "string",
  "name": "string",
  "volume": 1,
  "emoji_id": "string",
  "emoji_name": "string",
  "url": "https://example.com"
}
```

## 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` · MCP tool: `discord-soundboard-sounds-delete`

### Path parameters

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

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

Response 200:

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

## 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` · MCP tool: `discord-commands-list`

### Path parameters

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

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "type": 1,
      "type_name": "string",
      "description": "string",
      "options": [
        {
          "type": 1,
          "name": "string",
          "description": "string",
          "required": true
        }
      ],
      "default_member_permissions": "string",
      "nsfw": true,
      "version": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

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

### Path parameters

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

### Headers

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

### Body

- `name` (string; required; 1–32 characters)
- `type` (integer; one of 1, 2, 3): 1 slash, 2 user context menu, 3 message context menu
- `description` (string; ≤ 100 characters): Required for slash commands
- `options` (array of object; ≤ 25 items)
  - `options[].type` (integer)
  - `options[].name` (string)
  - `options[].description` (string)
  - `options[].required` (boolean)
- `default_member_permissions` (string | null): Permission bitfield required to see the command
- `nsfw` (boolean)

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

```json
{
  "id": "string",
  "name": "string",
  "type": 1,
  "type_name": "string",
  "description": "string",
  "options": [
    {
      "type": 1,
      "name": "string",
      "description": "string",
      "required": true
    }
  ],
  "default_member_permissions": "string",
  "nsfw": true,
  "version": "string"
}
```

## 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` · MCP tool: `discord-commands-get`

### Path parameters

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

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

Response 200:

```json
{
  "id": "string",
  "name": "string",
  "type": 1,
  "type_name": "string",
  "description": "string",
  "options": [
    {
      "type": 1,
      "name": "string",
      "description": "string",
      "required": true
    }
  ],
  "default_member_permissions": "string",
  "nsfw": true,
  "version": "string"
}
```

## 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` · MCP tool: `discord-commands-update`

### Path parameters

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

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

```json
{
  "id": "string",
  "name": "string",
  "type": 1,
  "type_name": "string",
  "description": "string",
  "options": [
    {
      "type": 1,
      "name": "string",
      "description": "string",
      "required": true
    }
  ],
  "default_member_permissions": "string",
  "nsfw": true,
  "version": "string"
}
```

## 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` · MCP tool: `discord-commands-delete`

### Path parameters

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

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

Response 200:

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

## 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: `write` · MCP tool: `discord-commands-register-defaults`

### Path parameters

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

### Headers

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

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

Response 200:

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

## 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: `write` · MCP tool: `discord-commands-permissions`

### Path parameters

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

### Headers

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

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

Response 200:

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


---

Source: https://socialit.com/docs/api-reference/focus-discord/
