Feed Elements Capability, Moderation

Get information about a feed element's moderation capability, add a moderation flag to a feed element, or delete all moderation flags from a feed element.

Resource

1/connect/communities/communityId/chatter/feed-elements
2/feedElementId/capabilities/moderation

Available version

31.0

Requires Chatter

Yes

HTTP methods

GET, POST, DELETE, HEAD

Request parameters for GET

Parameter 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. One of these values: `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	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

Parameter 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.

If a type isn’t specified, it defaults to FlagAsInappropriate.

Optional

If not specified, FlagAsInappropriate is the default value.

38.0

visibility

String

Visibility behavior of a flag for various user types. One of these values:

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

31.0

Response body for GET and POST

Moderation Capability

If the feed element doesn’t support this capability, the response is 404: Not Found.

Connect REST API Developer Guide

Feed Elements Capability, Moderation