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

  • colorScheme

    Defaults to null

    Choices: auto, dark, light

  • commentsLinkOne

    Defaults to null

    Maximum length of 50

  • guidelines

    Defaults to null

  • adsProductVideoEnabled

    Defaults to null

  • adsPositionTopEnabled

    Defaults to null

  • unapproveLinks

    Defaults to null

  • commentsLinkZero

    Defaults to null

    Maximum length of 50

  • linkAffiliationEnabled

    Defaults to null

  • category

    Defaults to null

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

  • adsProductStoriesEnabled

    Defaults to null

  • attach allows multiple

    Defaults to []

    Choices: followsForum, forumCanDisableAds, forumForumCategory, counters, forumDaysAlive, forumIntegration

  • organicDiscoveryEnabled

    Defaults to null

  • twitterName

    Defaults to null

    Maximum length of 255

  • adsProductDisplayEnabled

    Defaults to null

  • commentsLinkMultiple

    Defaults to null

    Maximum length of 50

  • adsProductLinksEnabled

    Defaults to null

  • installCompleted

    Defaults to null

  • unapproveReputationLevel

    Defaults to null

    Valid values are:
    1: LOW1
    2: LOW2
    3: AVERAGE
    4: HIGH

  • website

    Defaults to null

    URL (defined by RFC 3986)

  • adsProductLinksThumbnailsEnabled

    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

  • forumCategory

    Defaults to null

    Looks up a forum category by ID

  • 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

  • validateAllPosts

    Defaults to null

  • flaggingEnabled

    Defaults to null

  • adsPositionInthreadEnabled

    Defaults to null