• Document Up to Date
  • Updated On 4.0.0

Update Comment Flags

Adds a flag to the given comment.

Resource Information

This service uses the tomcat application on port 8080 by default.

The context for this API is /crafter-social, please prefix the API URLs with this context.

HTTP Verb
POST
URL
/api/3/comments/:id/flags
Response Formats
JSON

Parameters

Name
Type
Required
Description
context
String
The ID of the Social Context
id
String
The ID of the comment to update
reason
String
Reason why the comment is been flagged

Example

Request

POST .../api/3/comments/59678d3f300426156e21df50/flags?context=f5b143c2-f1c0-4a10-b56e-f485f00d3fe9
reason=Contains offensive language

Response

Status 200 OK

 1{
 2  "ancestors": [],
 3  "targetId": "Welcome",
 4  "subject": "",
 5  "body": "This was the first comment in the site!",
 6  "createdBy": "59667e8abd4787992596ba6b",
 7  "lastModifiedBy": "59667e8abd4787992596ba6b",
 8  "createdDate": "2017-07-13T09:09Z",
 9  "lastModifiedDate": "2017-07-13T15:17Z",
10  "anonymousFlag": false,
11  "attributes": {},
12  "attachments": [
13    {
14      "md5": "c86b6b1607621afff04b6a9b9048e87b",
15      "fileId": "5967c9dd300426156e21df53",
16      "contentType": "image/png",
17      "fileSize": "144.5 KB",
18      "storeName": "/f5b143c2-f1c0-4a10-b56e-f485f00d3fe9/59678d3f300426156e21df50/person1.png",
19      "fileName": "person1.png",
20      "savedDate": "2017-07-13T13:28Z",
21      "fileSizeBytes": 147970,
22      "attributes": {
23        "owner": "59678d3f300426156e21df50"
24      }
25    }
26  ],
27  "moderationStatus": "APPROVED",
28  "votesUp": [],
29  "votesDown": [],
30  "flags": [
31    {
32      "reason": "Contains offensive language",
33      "userId": "59667e8abd4787992596ba6b",
34      "_id": "5967e35f300426156e21df58"
35    }
36  ],
37  "_id": "59678d3f300426156e21df50"
38}

Responses

Status
Location
Response Body
200

See example above.
401

{ "message" : "User must be logged in" }
403







{ "message" : "Current subject does not have
permission to execute global action ..." }
500

{ "message" : "Internal server error" }