Flag a comment as inappropriate 

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

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

To flag a blog comment as inappropriate...

  1. Find the self link of the blog comment that you want to flag by retrieving a feed of blog comments. Make a note of the value of its href attribute. For example:


  2. Create a report entry document in Atom format. In it, define the blog comment that you want to flag by including a <link> element that specifies the web address you noted in the previous step in its href attribute. For example:

      <?xml version="1.0" encoding="utf-8" ?>
      <entry xmlns="http://www.w3.org/2005/Atom">
       label="Legal issue"/>
      <link rel="related" href="self url from the subscription feed"/>
      <content type="text">This comment contains content that is against company policy</content>

  3. Pass the report entry document in with the POST request detailed in the table.

Table 1. Atom API request details

Method Resource URI Input representation
POST Inappropriate content reporting mechanism /{homepage}/api/reports/comments

Note: {homepage} represents the blog handle of the blog configured to be the home page of the Blogs application. The handle is defined when the home page blog is created by the administrator.

Note: Starting with version 3, use this URI to flag a post.

POST Inappropriate content reporting mechanism Value of the href attribute of the <link> element with the rel="http://www.ibm.com/xmlns/prod/sn/reports" attribute for each blog entry.

Note: This method is available for backwards compatibility.



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 204


Parent topic

Flag blog content

Related reference
Getting a list of inappropriate content flag options for Blogs
Navigate Blogs subscription API resources
Navigate Blogs publishing API resources
Report entry content