Community articleGetting a list of community file comments that require action
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 are awaiting action by the moderator.



Get a feed that lists the community file comments that 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="approval-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 entries returned in the feed. Separate multiple parameters with an ampersand (&).


 

Output


An Atom feed containing the comments that are awaiting moderator action.

 

Input
Method URI Description
GET /files/basic/api/approval/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="approval-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.
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:
  • pending
  • rejected
Output
Content Type: application/atom+xml