Comment Resources

February 25, 2013 · View on GitHub

POST comments/:id/comments

Description

Creates a reply to an existing comment. Comments can only be nested one level deep, you cannot reply to a reply of a comment. If a comment has a non-null parent_id value then it cannot be replied to.


Requires authentication

OAuth


Parameters

  • body (required) — Content of the comment.

Return format

A JSON object with key "status" and value of 200, a key "message" with value of "Successfully added a comment.", and a key of "comment" including the comment model of the comment that was created.


Errors

All known errors cause the resource to return HTTP error code header together with a JSON array containing at least 'status' and 'error' keys describing the source of error.

  • 400 Bad Request — The body of the comment was not specified.
  • 404 Not Found — The specified comment was not found.

Example

Request

POST v1/comments/73249443/comments

Body

body=Nice+color+and+composition.

Result

{
  "status" : 200,
  "message" : "Successfully added a comment.",
  "error" : "None"
  "comment": {
    "id": 83858343,
    "user_id": 198867,
    "to_whom_user_id": 347823,
    "body": "Nice color and composition.",
    "created_at": "2013-02-25T17:35:26-05:00",
    "parent_id": 73249443,
    "flagged": false,
    "rating": 0,
    "voted": false,
    "user": {
      "id": 198867,
      "username": "tye",
      "firstname": "Tye",
      "lastname": "Shavik",
      "city": "Toronto",
      "country": "Canada",
      "fullname": "Tye Shavik",
      "userpic_url": "http://acdn.500px.net/198867/7f5f29fd33e093062a30e2bf3a9e605c446ba960/1.jpg?29",
      "upgrade_status": 2,
      "followers_count": 36,
      "affection": 103,
      "admin": 1
    }
  }
}