Chatter REST API Developer's Guide

Introducing Chatter REST API
Chatter REST API Quick Start
Chatter REST API Features
Chatter REST API Examples
Chatter REST API Resources
Action Links Resources
Announcements Resource
Batch Resource
Chatter Resource
Comments Resources
Communities Resources
Communities Moderation Resources
Connect Resources
Dashboard Component Snapshot Resource
Datacloud Resources
Feed Elements Resources
Feed Items Resources
Feeds Resources
Files Connect Repository Resources
Files Resources
Folders Resources
Groups Resources
Influence Resource
Likes Resource
Managed Topics Resources
Mentions Resources
Motifs Resources
Push Notifications Resource
Question and Answers Suggestions Resource
Recommendation Definition Resources
Records Resources
Scheduled Recommendations Resources
Subscriptions Resource
Topics Resources
User Profiles Resource
Users Resources
User Information
User Profile Information
Batch User Information
User Conversations, General
User Conversations, Specific
Change Status of Conversations
Get Unread Count for Conversations
Users Files, General
User Files, Filtered by Group
User Files, Filtered by Sharing
User Followers
Following
User Groups
Topics a User is Knowledgeable About
User Messages, General
User Messages, Specific
User Photo
User Recommendations, General
User Recommendations for a Specific Action
User Recommendations for a Specific Action and Object Category
User Recommendations for a Specific Action and Key Prefix
User Recommendations for a Specific Action and Object ID
User Recommendations for a Specific Action and Object Type
User Reputation
User Settings
User Status
Topics Recently Used
Zones Resources
Chatter REST API Request Bodies
Chatter REST API Response Bodies
Chatter REST API Appendices
PDF

Newer Version Available

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

Following

Returns a list of people, groups, records, topics, and files that the specified user is following. Also used to follow records. See Using POST, PATCH, or PUT for Input.

You can't use the users resource to add a user to a group. Use the groups resource instead.

Note

Resource
1/chatter/users/userId/following
1/connect/communities/communityId/chatter/users/userId/following
Available since version
23.0
Following topics is available since version 29.0.
Requires Chatter
Yes
HTTP methods
GET, POST, or HEAD
Request body for POST
Root XML tag
<following>
Properties
Name Type Description Available Version
subjectId String The ID of what to follow, for example, a user ID, a record ID, a file ID, a topic ID, and so on.

Use Group Member Input for adding members to groups.

Note

 23.0

Topic IDs are available in 29.0
Request parameter for POST
Parameter Name Type Description Available
subjectId String This request enables the user to follow the specified record. This could be a user ID, a file ID, a topic ID, and so on. 23.0

Topic IDs are available in 29.0
Request parameters for GET or HEAD
All parameters are optional.
Parameter Name Type Description
filterType String Specifies the key prefix to filter the type of objects returned. The key prefix is the three-character prefix code in the object ID. Object IDs are prefixed with three-character codes that specify the type of the object. For example, User objects have a prefix of 005 and Group objects have a prefix of 0F9.

You don’t need to generate the key prefixes yourself. Use the List of Filter Feed URLs to see the available key prefixes.
page Integer Specifies the page number to return. The default value is 0, which returns the first page.
pageSize Integer Specifies the number of items per page. Valid values are between 1 and 1000. If you don't specify a size, the default is 25.
Response body for GET or HEAD
Following Page
Response body for POST
Subscription