Chatter REST API Developer's Guide

Clouds with binary code floating aboveCloud with binary code floating above

No Results

Search Tips:

  • Please consider misspellings
  • Try different search keywords
PDF

Newer Version Available

This content describes an older version of this product. View Latest

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