API Documentation

threads/update Beta

This method is currently under development and subject to change.

Updates information on a thread.

URL

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

  • thread

    You must be the author of the post or a moderator on the applicable forum.

Optional

  • category

    Defaults to null

    Looks up a category by ID

  • old_identifier

    Defaults to null

    Only valid if 'identifier' is provided. See 'identifier' for more information.
    Maximum length of 300

  • forum

    Defaults to null

    Looks up a forum by ID (aka short name)

  • title

    Defaults to null

    Maximum length of 200

  • url

    Defaults to null

    URL (defined by RFC 3986)
    Maximum length of 500

  • author

    Defaults to null

    You must be a moderator on the applicable forum to change a thread author.
    You may look up a user by username using the 'username' query type.

  • message

    Defaults to null

  • identifier

    Defaults to null

    To update a specific identifier, provide 'old_identifier'. If no identifier exists, a new one is created.
    Maximum length of 300

  • slug

    Defaults to null

    Alpha-numeric slug
    Maximum length of 200

Example Responses

Expand json

POST thread=1&title=Hello+World

{
  "code":0,
  "response":{
    "category":"1",
    "reactions":0,
    "identifiers":[
      "my-identifier"
    ],
    "forum":"bobross",
    "title":"Hello World",
    "dislikes":0,
    "isDeleted":false,
    "author":"1",
    "userScore":0,
    "id":"1",
    "isClosed":false,
    "posts":127,
    "link":null,
    "likes":0,
    "message":"\"If you've painted before you know that we don't make mistakes -- we have happy accidents.\"",
    "ipAddress":"127.0.0.1",
    "slug":"happy_accidents",
    "createdAt":"2008-06-10T01:31:43"
  }
}