Feed-Items Topics

Only users with the Assign Topics permission can add or remove existing topics from feed items. Only users with the Create Topics permission can add new topics to feed items.

Resource

1/chatter/feed-items/feedItemId/topics

Available versions

28.0–31.0

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

Important

Requires Chatter

Yes

HTTP methods

DELETE, POST

Request parameter for DELETE

Parameter Name	Type	Description	Required or Optional	Available Version
topicId	String	ID of an existing topic	Required	28.0–31.0

Request body for POST

Root XML tag

<feedItemTopic>

JSON

The following example attaches a new topic to a feed item:

1{ "topicName": "W3C"
2}

Properties

Name	Type	Description	Required or Optional	Available Version
topicId	String	ID of an existing topic	Required for existing topics if the topicName property isn’t used	29.0
topicName	String	Name of a new or existing topic, up to 150 characters	Required for new topics; required for existing topics if the topicId property isn’t used	29.0

Request parameters for POST

Parameter Name	Type	Description	Required or Optional	Available Version
topicId	String	ID of an existing topic	Required for existing topics if the topicName parameter isn’t used	28.0–31.0
topicName	String	Name of a new or existing topic, up to 150 characters	Required for new topics; required for existing topics if the topicId parameter isn’t used	28.0–31.0

Response for DELETE

204: Successful Delete

Response body for POST

Topic

Example for POST

This example passes the ID of an existing topic in the topidId parameter to associate it with a feed item:

1/chatter/feed-items/0D5D0000000JmiB/topics?topicId=0TOD0000000090r