Moderation Flags on a Feed Item

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

Resource

1/connect/communities/communityId/chatter/feed-items/feedItemId/moderation-flags

Available version

29.0–31.0

In version 32.0 and later, use Feed Elements Capability, Moderation.

Important

Requires Chatter

Yes

HTTP methods

GET, DELETE, POST

Request parameters for GET

Name	Type	Description	Required or Optional	Available Version
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–31.0

Request body for POST

Root XML tag

<moderationFlag>

JSON

1{ 
2   "note" : "Flagged by moderator as spam on 6.6.16.",
3   "type" : "FlagAsSpam",
4   "visibility" : "ModeratorsOnly"
5}

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
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–31.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 post. If not specified and the context user is a moderator, removes all flags on the post.	Optional	29.0–31.0

Response body for GET and POST

Moderation Flags

Response for DELETE

204: Successful Delete