API Documentation

blacklists/add

Adds an entry to the blacklist.

URL

https://disqus.com/api/3.0/blacklists/add.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)

Optional

  • domain allows multiple

    Defaults to []

    Domain Name

  • word allows multiple

    Defaults to []

    Maximum length of 200

  • retroactive

    Defaults to false

    Deprecated. Apply blacklist retroactively to existing posts, marking them killed

  • notes

    Defaults to ""

    Maximum length of 50

  • ip allows multiple

    Defaults to []

    IP address in CIDR notation

  • dateExpires

    Defaults to null

    Unix timestamp (or ISO datetime standard)

  • shadowBan

    Defaults to false

  • user allows multiple

    Defaults to []

    Looks up a user by ID
    You may look up a user by username using the 'username' query type.

  • retroactiveAction

    Defaults to null

    Action to apply retroactively to existing posts. Leave blank to apply no action
    Valid values are:
    1: KILL
    2: SPAM

  • email allows multiple

    Defaults to []

    Email address (defined by RFC 5322)