Moderation Flags on a Feed Item

In communities, get a flagged post, flag a post for moderation, and delete moderation flags.

If the context user is a community moderator with the Moderate Communities Feeds permission, get the number of times community members flagged a post. Flag a post for moderation and delete all flags on a post.

If the context user isn’t a community 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, `FlagAsInappropriate` 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 for the community, 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

Connect REST API Developer Guide

Moderation Flags on a Feed Item