Zernio
Zernio
API Reference

Discord

Settings

Get Discord account settingsGETUpdate Discord settingsPATCHList Discord guild channelsGET

Messaging

Send a Discord Direct MessagePOSTList pinned messagesGETPin a Discord messagePUTUnpin a Discord messageDELETECreate a Discord public threadPOSTCrosspost Discord messagePOSTDelete a Discord channel messageDELETE

Roles & Members

List Discord guild rolesGETCreate a Discord guild rolePOSTEdit a Discord guild rolePATCHDelete a Discord guild roleDELETEList Discord guild membersGETSearch Discord guild membersGETGet a Discord guild memberGETAssign a role to a guild memberPUTRemove a role from a guild memberDELETE

Scheduled Events

List Discord scheduled eventsGETCreate a Discord scheduled eventPOSTGet a Discord scheduled eventGETUpdate a Discord scheduled eventPATCHDelete a Discord scheduled eventDELETE
Dashboard
llms.txtOpenAPI
OverviewPlatformsAPI ReferenceResources
Discord

Pin a Discord message

Pin a specific message in a channel. Path shape mirrors Discord's own API (PUT /channels/{cid}/pins/{mid}).

Idempotent: re-pinning an already-pinned message is a 204 no-op.

Constraints:

  • Bot needs MANAGE_MESSAGES in the channel.
  • 50-pin cap per channel: hitting it returns 400 (Discord-side). Caller should unpin one first.
PUT
/v1/discord/channels/{channelId}/pins/{messageId}

Authorization

bearerAuth
AuthorizationBearer <token>

API key authentication: send your Zernio API key in the Authorization header, prefixed with Bearer.

In: header

Path Parameters

channelId*string
messageId*string

Query Parameters

accountId*string

Response Body

application/json

application/json

import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.discord.pinDiscordMessage({  path: {    channelId: 'channel_abc123',    messageId: 'message_abc123',  },  query: {    accountId: 'account_abc123',  },});console.log(data);
{  "success": true,  "operation": "message_pinned",  "channelId": "string",  "messageId": "string"}
Was this page helpful?

List pinned messages

Returns the channel's pinned messages, sorted most-recently-pinned first. Discord caps a channel at 50 pinned messages and returns the full list unpaginated. Bot needs READ_MESSAGE_HISTORY in the channel (granted by default BOT_PERMISSIONS).

Unpin a Discord message

Unpin a message. Same MANAGE_MESSAGES permission requirement as pin. Idempotent: unpinning a non-pinned message is a 204 no-op.