Community articleGetting a list of flagged community file comments
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

Get a feed that lists the community file comments that have been flagged as inappropriate and are awaiting action by the moderator.



Get a feed that lists the community file comments that have been flagged as inappropriate and are awaiting action by the moderator.


Discoverability


You can derive the URL from the moderation service document. Find the comments-moderation workspace. Use the web address in the href attribute of the <collection> element that contains the <category term="review-content" ... /> element.

Authentication


The user authenticating the request must be a global-moderator of the Files application.

Request parameters


You can use one or more of the input parameters to limit the number of posts returned in the feed. Separate multiple parameters with an ampersand (&).


Output


An Atom feed containing the comments that have been flagged as inappropriate.

 

Input
Method URI Description
GET /files/basic/api/review/comments You can derive the URL from the moderation service document. Find the comments-moderation workspace. Use the web address in the href attribute of the <collection> element that contains the <category term="review-content" ... /> element.
Name Type Optional Description
community
string Yes Unique ID of a community. Limits the entries returned to include only those that are part of the specified community's file collection.
page
int Yes Page number. Specifies the page to be returned. The default value is 1, which returns the first page.
ps
int Yes Page size. Specifies the number of entries to return per page. The default value is 10. The maximum value you can specify is 500.
sortBy
enumerated Yes Specifies what value to use as the basis for organizing the entries returned in the feed. There is only one option:
date
Sorts the entries by the date on which it was changed to its current moderation status.
If status = "isFlagged," "date" means the date on which the last media flag was created. If status = "quarantined," "date" means the date on which the media status was changed to quarantined.
Authorized values:
  • date
sortOrder
enumerated Yes Specifies the order in which to sort the results. The options are:
asc
Sorts the results in ascending order.
desc
Sorts the results in descending order.
Authorized values:
  • asc
  • desc
status
enumerated Yes Limits the number of entries returned to include only those having the specified status.
Authorized values:
  • isFlagged
  • quarantined
Output
Content Type: application/atom+xml