Act on a community file comment that is awaiting approval
To programmatically take action on a community file comment that is waiting to be approved, send an Atom entry document that defines the action you want to take to the moderation action feed.Only the moderator can take action on comments awaiting approval.
See Authenticating requests for information about how to authenticate the request.
To take action on a comment awaiting approval...
- Retrieve the moderation service document. See Retrieve the Files moderation service document for more details.
- 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="approval-action" .../> child element, and make a note of the web address in its href attribute.
- Find the entry representing the comment that you want to take action on by getting a list of the comments awaiting approval. See Getting a list of community file comments that require action for more details. Make a note of the value of the <td:uuid> element for the entry representing the comment.
- Create an Atom entry document that defines the action you want to perform. In the <snx:moderation action="xxx" /> element, choose one of the following options:
approve
Approves the comment and publishes it to the community file entry.
reject
Rejects the request for publication and does not publish the comment.
Construct an <snx:in-ref-to> element that identifies the comment that you want to take action on using the following syntax:
<snx:in-ref-to xmlns:snx="http://www.ibm.com/xmlns/prod/sn" rel="http://www.ibm.com/xmlns/prod/sn/report-item" ref-item-type="comment" ref="<value_of_td:uuid>" > </snx:in-ref-to> <snx:moderation action="approve" />where <value_of_td:uuid> is the value of the <td:uuid> element that you noted in Step 3.
For example, to approve a comment, the Atom entry document might contain the following content:
<?xml version="1.0"?> <entry xmlns="http://www.w3.org/2005/Atom" xmlns:snx="http://www.ibm.com/xmlns/prod/sn"> <id>ignored</id> <title>ignored</title> <author> <name>ignored</name> <!-- taken from authenticated moderator user --> </author> <snx:in-ref-to xmlns:snx="http://www.ibm.com/xmlns/prod/sn" rel="http://www.ibm.com/xmlns/prod/sn/report-item" ref-item-type="comment" ref="eb88546b-cf1e-482b-a032-458fdbf5bfba"> </snx:in-ref-to> <snx:moderation action="approve" /> <content>This content of this comment is not objectionable according to company guidelines.</content> </entry>
- Send a POST request to the web address that you noted in Step 2. Pass the Atom entry document that you created in the previous step as input on the request.
Table 1. Atom API request details
Method Resource URI Input representation POST Premoderation content approval status collection Value of the href attribute of the <collection> element that has a <atom:category term="approval-action" .../> child element in the moderation service document. moderation action
Input
Provide a moderation action Atom entry document. The content type of the Atom entry document must be application/atom+xml.
Output
None.Returned HTTP headers
HTTP/1.1 204 No Content
Indicates that the comment was successfully moderated. If an error occurs, this header contains one of the error codes.
- HTTP/1.1 400 Bad Request
- HTTP/1.1 401 Unauthorized
- HTTP/1.1 403 Forbidden. Returned when the current user is authorized to the use the API, but cannot moderate the specified content.
- HTTP/1.1 404 Not Found. Indicates that the content is no longer available.
Example
Request:
> POST /files/basic/api/approval/actions/comments HTTP/1.1 > Authorization: Basic xxx > Host: enterprise.example.com > Accept: */* > Content-Type: application/atom+xml > Content-Length: 509Response:
< HTTP/1.1 204 No Content
Parent topic
Work with community file comments that are awaiting approvalRelated reference
Moderation action entry content