Feed Elements Capability, Status

Access the status capability of a feed post or set the status of a feed post.

Only users with the Can Approve Feed Post and Comment permission can set the status of a feed post or comment.

Resource
/chatter/feed-elements/feedElementId/capabilities/status
/connect/communities/communityId/chatter/feed-elements/feedElementId/capabilities/status
Available version
37.0
Requires Chatter
Yes
HTTP methods
GET, HEAD, PATCH
Response body for GET
Status Capability

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

Request body for PATCH
Root XML tag
statusCapability
JSON example
{
   "feedEntityStatus":"Published"
}
Properties
Name Type Description Required or Optional Available Version
feedEntityStatus String Status of the feed post or comment. Values are:
  • Draft—The feed post isn’t published but is visible to the author and users with Modify All Data or View All Data permission. Comments can’t be drafts.
  • Isolated—The feed post or comment is isolated, and only admins can see it.
  • PendingReview—The feed post or comment isn’t approved yet and therefore isn’t published or visible.
  • Published—The feed post or comment is approved and visible.

Posts that have a status of PendingReview or Published can’t be changed to a status of Draft and vice versa. Only admins can change the status of a post or comment to or from Isolated status.

Required 37.0
Request parameters for PATCH
Parameter Name Type Description Required or Optional Available Version
feedEntityStatus String Status of the feed post or comment. Values are:
  • Draft—The feed post isn’t published but is visible to the author and users with Modify All Data or View All Data permission. Comments can’t be drafts.
  • Isolated—The feed post or comment is isolated, and only admins can see it.
  • PendingReview—The feed post or comment isn’t approved yet and therefore isn’t published or visible.
  • Published—The feed post or comment is approved and visible.
Required 37.0
Response body for PATCH
Status Capability

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