Flag a file comment as inappropriate 

To flag a file comment as inappropriate, send an Atom entry document containing the report to the Files content reporting mechanism.

See Authenticating requests for information about how to authenticate the request.

To flag a file comment as inappropriate...

  1. Retrieve a feed that contains the file comment that you want to flag. For details, see Getting a feed of a file's comments.

  2. Find the entry that represents the file comment, and then make a note of the value of its <td:uuid> element.

  3. Create a report entry document to send as input on the request. In it, identify the file comment that you want to flag by including a link element that contains a ref attribute equal to the <td:uuid> value that you noted in the previous step. For example:

       ref-item-type="comment" />
      <content type="text">Human Resources would object to this comment.</content>

  4. Send a POST request to the URI specified in the table below. Pass the report entry document as input on the request.

Table 1. Atom API request details

Method Resource URI Input representation
POST Inappropriate content reporting mechanism /basic/api/reports report


Provide a report Atom entry document. The content type of the Atom entry document must be application/atom+xml.



Returned HTTP headers

HTTP/1.1 202


Parent topic

Flag Files content

Related reference
Report entry content