Get a feed that lists a history of the flags raised on a given file.
Table 1. Atom API request details
|HTTP Method||Sample URL|
is the value of the <td:uuid> or <td:label> elements in the file's Atom entry document.
You can derive the URL from the Flagged Entries feed. Use the web address in the href attribute of the <link> element with the rel="http://www.ibm.com/xmlns/prod/sn/history" attribute for the entry representing the flagged file.
The user authenticating the request must be the moderator of the Files application.
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 (&).
Table 2. Input parameters
|filter||Value with which to filter the returned entries. Options are:|
Any flag record, dismissed or not.flagIsDismissed
Only flag records that have been dismissed.flagIsRaised
Only flag records that have not been dismissed.The default value for this parameter is flagIsRaised.
|page||Page number. Specifies the page to be returned. The default value is 1, which returns the first page.|
|ps||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||Species what value to use as the basis for organizing the entries returned in the feed. There is only one option: |
Sorts the entries by the date on which it was changed to its current moderation status. In this case, it is the date on which the flag was created.
|sortOrder||Specifies the order in which to sort the results. The options are: |
Sorts the results in ascending order.desc
Sorts the results in descending order.The default is desc.
An Atom feed containing the reports associated with the specified file.
Parent topic: Managing flagged content in the Communities Files widget