Community articleGetting a list of flagged community files
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 files that have been flagged as inappropriate and are awaiting action by the moderator.



Get a feed that lists the community files 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 documents-moderation workspace. Use the web address in the href attribute of the <collection> element that contains the <category term="review-content" ... /> element.

Authentication


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 community files that have been flagged as inappropriate.

 

Input
Method URI Description
GET /files/basic/api/review/documents You can derive the URL from the moderation service document. Find the documents-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