Feed-Items Topics

The topics associated with a specific feed item. Associate a new or existing topic with a specific feed item. Remove a topic from a specific feed item. 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 body 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

Chatter REST API Developer Guide

Feed-Items Topics