Get the history of a flagged file 

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

Resource Description
From the Flagged Entries feed, use the web address in the href attribute of the <link> element with the rel="" 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

Parameter Description
filter Value with which to filter the returned entries. Options are:

    Any flag record, dismissed or not.


    Only flag records that have been dismissed.


    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.


    Displays the entries in descending order.

The default is desc.


An Atom feed containing the reports associated with the specified file.

Parent topic

Manage flagged content in the Communities Files widget