API Documentation

forums/update

Updates forum details.

URL

https://disqus.com/api/3.0/forums/update.json

Accessibility

public key, secret key

Supported request methods

POST

Supported formats

json, jsonp

Requires authentication

yes

Rate limited

inherits global rate limit

Arguments

Required

  • forum

    Looks up a forum by ID (aka short name)
    You must be a moderator on the selected forum.

Optional

  • sort

    Defaults to null

    Valid values are:
    1: OLDEST
    2: NEWEST
    4: HOT

  • flagThreshold

    Defaults to null

  • initialCommentCount

    Defaults to null

    Minimum value of 1
    Maximum value of 50

  • behindClickEnabled

    Defaults to null

  • colorScheme

    Defaults to null

    Choices: auto, dark, light

  • commentsLinkOne

    Defaults to null

    Maximum length of 50

  • guidelines

    Defaults to null

  • adsPositionTopEnabled

    Defaults to null

  • adsPositionPollEnabled

    Defaults to null

  • unapproveLinks

    Defaults to null

  • commentsLinkZero

    Defaults to null

    Maximum length of 50

  • disableDisqusBranding

    Defaults to null

  • aetBannerConfirmation

    Defaults to null

  • adsPositionRecommendationsEnabled

    Defaults to null

  • linkAffiliationEnabled

    Defaults to null

  • category

    Defaults to null

    Choices: Tech, Living, Style, Business, Entertainment, Celebrity, Sports, Culture, Games, News

  • aetBannerEnabled

    Defaults to null

  • aetBannerTitle

    Defaults to null

  • attach allows multiple

    Defaults to []

    Choices: followsForum, forumCanDisableAds, forumForumCategory, counters, forumDaysAlive, forumFeatures, forumIntegration, forumNewPolicy, forumPermissions

  • threadRatingsEnabled

    Defaults to null

  • organicDiscoveryEnabled

    Defaults to null

  • twitterName

    Defaults to null

    Maximum length of 255

  • votingType

    Defaults to null

    Valid values are:
    0: DETAILED
    1: DOWNVOTE_LIMITED
    2: DOWNVOTE_DISABLED
    3: DISABLED

  • daysUnapproveNewUsers

    Defaults to null

    Minimum value of 1
    Maximum value of 99

  • commentsLinkMultiple

    Defaults to null

    Maximum length of 50

  • linkColor

    Defaults to null

    Maximum length of 7

  • commentsPlaceholderTextPopulated

    Defaults to null

    Maximum length of 45

  • commentsPlaceholderTextEmpty

    Defaults to null

    Maximum length of 45

  • installCompleted

    Defaults to null

  • website

    Defaults to null

    URL (defined by RFC 3986)

  • disableSocialShare

    Defaults to null

  • allowAnonPost

    Defaults to null

  • translationLanguage

    Defaults to null

    Translation Language

  • description

    Defaults to null

    Maximum length of 300

  • moderatorBadgeText

    Defaults to null

    Maximum length of 50

  • shouldError

    Defaults to false

  • adultContent

    Defaults to null

  • customFont

    Defaults to null

  • gifPickerEnabled

    Defaults to null

  • commentPolicyText

    Defaults to null

  • forumCategory

    Defaults to null

    Looks up a forum category by ID

  • disableDisqusBrandingOnPolls

    Defaults to null

  • badgesEnabled

    Defaults to null

  • commentPolicyLink

    Defaults to null

    URL (defined by RFC 3986)

  • unapproveNewUsersEnabled

    Defaults to null

  • aetBannerDescription

    Defaults to null

  • disableThirdPartyTrackers

    Defaults to null

  • flaggingNotifications

    Defaults to null

  • name

    Defaults to null

  • mediaembedEnabled

    Defaults to null

  • typeface

    Defaults to null

    Choices: auto, serif, sans-serif

  • adsPositionBottomEnabled

    Defaults to null

  • daysThreadAlive

    Defaults to null

    Maximum value of 10000

  • validateAllPosts

    Defaults to null

  • flaggingEnabled

    Defaults to null

  • adsPositionInthreadEnabled

    Defaults to null