Discord

Update Discord settings

Changed on

Update Discord account settings. Supports two operations (can be combined):

  1. Webhook identity - Set the default display name and avatar that appear as the message author on every post. These are account-level defaults; individual posts can override them via platformSpecificData.webhookUsername / webhookAvatarUrl.

  2. Switch channel - Move the connection to a different channel in the same guild. A new webhook is automatically created in the target channel.

patch/v1/accounts/{accountId}/discord-settings

Request

  • Base URL: https://zernio.com/api
  • URL: https://zernio.com/api/v1/accounts/{accountId}/discord-settings
  • Auth: HTTP bearer

Path parameters

accountIdstring required

Request body

webhookUsernamestring

Custom display name for the webhook (1-80 chars). Empty string resets to default ("Zernio"). Cannot contain "clyde" or "discord".

webhookAvatarUrlstring

Custom avatar URL. Empty string resets to default bot avatar.

channelIdstring

Switch to a different channel in the same guild. Must be a text (0), announcement (5), or forum (15) channel.

Response

Settings updated

messagestring

Example response

{
  "message": "Discord settings updated"
}

Changes

  • f8c8f34fb41aRevision changes
    • warning

      added the new account enum value to the / response property for the response status

  • d556591af3f6Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status