POST /api/messages/:message_id/comments

create a new comment

Success Response Code: 201

Params

Param name Description
message_id
required

id of the message to which the comment belongs


Value: Must be a Integer
comment
optional

Value: Must be a Hash
comment[text]
required

text for the comment


Value: Must be a String
comment[attachment]
optional

file to attach to this comment. Should be sent as an HTTP multipart form


Value: Must be a File
comment[attachment_ids]
optional

existing attachment to be connected to this comment


Value: Must be an array of Integer

Response Fields

recipients list of users and groups that have been @ mentioned in this thread Array<Recipient>
tags list of tags that have been used in this thread Array<Tag>

Example Curl Commands

curl -X POST -v --basic -u "emily@socialcast.com:demo" https://demo.socialcast.com/api/messages/424/comments.json -H"Content-Type: application/json" -d'{"comment":{"text":"New comment!"}}'

Examples

POST /messages/42/comments.json
{
  "comment": {
    "text": "hello world"
  }
}
201
{
  "comment": {
    "id": 5,
    "url": "https://socialcast.socialcast.test/api/messages/42/comments/5",
    "user": {
      "id": 73,
      "first_name": "J'øhn67",
      "last_name": "D'øe67",
      "name": "J'øhn67 D'øe67",
      "html_name": "J&#39;øhn67 D&#39;øe67",
      "url": "https://socialcast.socialcast.test/users/73-j%C3%B8hn67d%C3%B8e67",
      "avatars": {
        "is_system_default": true,
        "id": null,
        "square16": "https://socialcast.socialcast.test/assets-test/v6/avatars/default_user_square16-3b951350d61d203ece2fa5dd274fa7bd35275e132c17310d9006514f8839c857.png",
        "square30": "https://socialcast.socialcast.test/assets-test/v6/avatars/default_user_square30-6db66ac25c338d1e548a68465e2723ff63367c2aafbcc01db24c83964056b892.png",
        "square45": "https://socialcast.socialcast.test/assets-test/v6/avatars/default_user_square45-16865426333e244c59076d4f2475b711ed1ff9d12c97f4cf354f373a0170a1fd.png",
        "square70": "https://socialcast.socialcast.test/assets-test/v6/avatars/default_user_square70-1708999e8f1fea583408d7fc64b2177f853e4123bea2ffcf35f4839c8697e0ba.png",
        "square140": "https://socialcast.socialcast.test/assets-test/v6/avatars/default_user_square140-7da7e1d98b33ef152280b1f653cfd80e2db24b01b625a72abc320673eea5af53.png"
      },
      "username": "Jøhn67Døe67",
      "active": true,
      "terminated": false,
      "inactive": false,
      "role": "member",
      "type": "User",
      "title": null,
      "out_of_office": false,
      "out_of_office_on": null,
      "back_in_office_on": null,
      "company_login": null
    },
    "text": "hello world",
    "html_body": "<div class=\"markdown-body\"><p>hello world</p></div>",
    "created_at": "2017-07-23T00:41:33-07:00",
    "updated_at": "2017-07-23T00:41:33-07:00",
    "attachments": [],
    "media_files": [],
    "permalink_url": "https://socialcast.socialcast.test/messages/42/comments/5",
    "editable": true,
    "deletable": true,
    "likable": false,
    "external_resources": [],
    "likes_count": 0,
    "likes": [],
    "recipients": [],
    "watchable": false,
    "watch": null,
    "tags": [],
    "thumbnail_url": null
  }
}