Feed Elements Capability, Comments Items

For additional information about posting a comment, see Using POST, PATCH, or PUT for Input.

To upload a binary file to attach to a comment, you must send it in a multipart/form-data request. To send the text of the comment, you can choose to include a JSON or XML rich input body part in the multipart/form-data request. Alternately, you can choose to pass the information in request parameter parts. For information about how to create the multipart/form-data message, see Uploading Binary Files.

Resource

1/chatter/feed-elements/feedElementId/capabilities/comments/items

1/connect/communities/communityId/chatter/feed-elements/feedElementId/capabilities/comments/items

Available version

32.0

Requires Chatter

Yes

HTTP methods

GET, POST

Request body for POST

Root XML tag

<comment>

Properties

Name	Type	Description	Available Version
attachment	Depends on type.	Optional. Values are: Attachment Input: Existing Content Attachment Input: New File Upload As of version 32.0, use the capabilities property. Important	24.0–31.0
body	Message Body Input	The body of the comment. Feed item and comment bodies have a 10,000 character limit. Because this limit can change, we recommend that clients make a describeSObjects() call on the FeedItem or FeedComment object. To determine the maximum number of allowed characters, look at the length of the Body or CommentBody field. To edit this property in a comment, make a PATCH request to /chatter/comments/commentId. Editing comments is supported in version 34.0 and later. Rich text and inline images are supported in comment bodies in version 35.0 and later.	23.0
capabilities	Comment Capabilities Input	Capabilities of the comment, such as a file attachment	32.0

Request parameters for POST

Parameter Name	Type	Description	Required or Optional	Available Version
text	String	The comment text.	Required	32.0

Request parameters for GET

Parameter Name	Type	Description	Required or Optional	Available Version
page	String	The page token to use to view the page. Use the value given in the nextPageUrl property of the Comment Page.	Optional	32.0
pageSize	Integer	The number of comments per page. The default value is 3.	Optional	32.0

Response body for GET

Comment Page

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

Response body for POST

Comment

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