Get a feed that lists a history of the flags raised on a given file.
The user authenticating the request must be the moderator of the Files application.
Table 1. Atom API request details
|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.||A feed that lists the reports associated with the specified file.|
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 first page is page 1.|
|ps||Page size. Specifies the number of entries to return per page. The default is 10.|
|sortBy||Species what value to use as the basis for organizing the entries returned in the feed. Option is:|
Orders the returned entries by the date on which the flag was created.
|sortOrder||Specifies the order in which to list the feed entries. The options are:|
Displays the entries in ascending order.desc
Displays the entries 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