Community articleUpdating a flagged comment on a community file
Added by IBM contributorIBM on June 23, 2014
Rate this article 1 starsRate this article 2 starsRate this article 3 starsRate this article 4 starsRate this article 5 stars

To update a community file comment that has been flagged as inappropriate, send a moderation action entry in Atom format to the href attribute of the comment's rel=edit link. You can update the comment's title and content elements only.



To update a community file comment that has been flagged as inappropriate, send a moderation action entry in Atom format to the href attribute of the comment's rel=edit link. You can update the comment's title and content elements only.

Only people with the global-moderator role can update the entry. See Authenticating requests for information about how to authenticate the request.

To update a comment, complete the following steps:

 

Note: The only updates that will be applied are changes that you make to the title and content elements.
  1. Retrieve the moderation service document. See Retrieving the Files moderation service document for more details.
  2. In the service document, locate the workspace with the <category term="comments-moderation" .../> child element, and then find the collection with the <atom:category term="review-content" .../> child element, and make a note of the web address in its href attribute.
  3. Send a GET request to the web address you copied from the previous step. In the returned feed, find the entry representing the comment that you want to update, and make a note of the web address for it, which is specified in the href attribute of its rel=edit link.
  4. Send a GET request to the URL that you noted in the previous step to retrieve the Atom document for the comment entry.
  5. Edit the Atom document to make your changes.
  6. Send a PUT request to the href in the rel=edit link for the comment to update it.

 

Input


Provide a comment Atom entry document.

Note: The content type of the Atom entry document must be application/atom+xml.

Output


None.
 

 

Input
Method URI Description
PUT /files/basic/api/review/comments/{commentId} Value of the href attribute of the <link rel="edit"> element of each entry in the Flagged Comments feed.
Content Type: application/atom+xml
Name Type Optional Description
commentId
string No The ID of the comment you wish to update.
Output
Code Description
200
OK. Indicates that the comment entry was successfully updated. If an error occurs, this header contains one of the error codes.
403
Forbidden. Authorization failed.
404
Not Found.