Experience Cloud Sites Moderation Resources

Available resources are:

Moderation Flags​ on Files

If the context user is a moderator, get the number of times members flagged a file. Also flag a file for moderation and delete all flags on a file.

If the context user isn’t a moderator, get whether the user flagged a file. Also flag a file for moderation and remove a flag the user previously added.

Resource

/connect/communities/communityId/files/fileId/moderation-flags

Available since release

36.0

In versions 30.0–35.0, use /connect/communities/communityId/chatter/files/fileId/moderation-flags.

HTTP methods

GET, DELETE, HEAD, POST

Request parameters for GET

Name	Type	Description	Required or Optional	Available Version
page	String	Specifies the page token to use to view a page of information. Page tokens are returned as part of the response class, such as currentPageToken or nextPageToken. If you pass in null, the first page is returned.	Optional	40.0
pageSize	Integer	Specifies the number of items per page. Valid values are from 1 through 100. The default size is 0.	Optional	40.0
visibility	String	Visibility behavior of a flag for various user types. ModeratorsOnly—The flag is visible only to users with moderation permissions on the flagged element or item. SelfAndModerators—The flag is visible to the creator of the flag and to users with moderation permissions on the flagged element or item.	Optional	30.0

Request body for POST

Root XML tag

<moderationFlag>

JSON

{ 
   "note" : "Flagged by moderator as spam on 6.6.16.",
   "type" : "FlagAsSpam",
   "visibility" : "ModeratorsOnly"
}

Properties

Name	Type	Description	Required or Optional	Available Version
note	String	A note of up to 4,000 characters about the flag.	Optional	38.0
type	String	Type of moderation flag. FlagAsInappropriate—Flag for inappropriate content. FlagAsSpam—Flag for spam.	Optional If not specified, FlagAs​Inappropriate is the default value.	38.0
visibility	String	Visibility behavior of a flag for various user types. ModeratorsOnly—The flag is visible only to users with moderation permissions on the flagged element or item. SelfAndModerators—The flag is visible to the creator of the flag and to users with moderation permissions on the flagged element or item.	Optional	30.0

Request parameters for POST

Name	Type	Description	Required or Optional	Available Version
note	String	A note of up to 4,000 characters about the flag.	Optional	38.0
type	String	Type of moderation flag. FlagAsInappropriate—Flag for inappropriate content. FlagAsSpam—Flag for spam.	Optional If not specified, FlagAs​Inappropriate is the default value.	38.0
visibility	String	Visibility behavior of a flag for various user types. ModeratorsOnly—The flag is visible only to users with moderation permissions on the flagged element or item. SelfAndModerators—The flag is visible to the creator of the flag and to users with moderation permissions on the flagged element or item.	Optional	30.0

Request parameters for DELETE

Name	Type	Description	Required or Optional	Available Version
userId	String	The ID of the context user. If specified, removes the flag the user previously added to the file. If not specified and the context user is a moderator, removes all flags on the file.	Optional	30.0

Response body for GET and POST

Moderation Flags

Flagged Files

Files that are flagged.

If the context user is a moderator, get the files that members flagged.

Resource

/connect/communities/communityId/files/moderation

Available since release

36.0

In version 30.0–35.0, use /connect/communities/communityId/chatter/files/moderation.

HTTP methods

GET, HEAD

Request parameters for GET

Name	Type	Description	Required or Optional	Available Version
page	Integer	Specifies the number of the page you want returned.	Optional	30.0
pageSize	Integer	Specifies the number of items per page. Valid values are from 1 through 100. If you don't specify a size, the default is 25.	Optional	30.0
q	String	A query string to filter the results. The string must contain at least two characters, not including wildcards. For information about wildcards, see Wildcards.	Optional	33.0

Response body

File Summary