Newer Version Available

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

Users Resources

Information about the user, such as who is following the user, the user’s files or recommendations. Also used for posting feed items and updating conversation status.
Available resources are:
Resource Description
/chatter/users Returns information about all users in an organization.
/chatter/users/me Information about the logged-in or specified user's Chatter profile.
/chatter/users/batch/user_list Returns information about the specified users’ profiles.
/chatter/users/me/conversations Returns all private conversations for the logged–in user. Also used to search across all conversations.
/chatter/users/me/conversations/conversationId Returns information about the specified private conversation for the logged-in user. Also used to search within a specific conversation.
/chatter/users/me/conversations/conversationId/mark-read Changes the status of the specified conversation.
/chatter/users/me/conversations/unread-count Returns the number of conversations that have unread messages for the logged-in or specified user.
/chatter/users/me/files/ Post a file or get information about files a user owns. These files don’t include files shared with a user, files a user follows, or general organization files.
/chatter/users/me/files/filter/groups Returns information about files posted to groups that the specified user is a member of.
/chatter/users/me/files/filter/sharedwithme Returns information about files that have been shared with the specified user.
/chatter/users/me/followers Returns information about the followers for the specified user.
/chatter/users/me/following Returns a list of people, groups, records, topics, and files that the specified user is following. Also used to follow records.
/chatter/users/me/groups The groups the specified user is a member of.
/chatter/users/me/knowledgeable-about-topics Topics that the specified user is knowledgeable about. Get a list of topics for the specified user.
/chatter/users/me/messages Returns all the messages for all the private conversations for the logged-in user. Also used to search across all messages and post a message.
/chatter/users/me/messages/messageId Returns the specified Chatter private message.
/chatter/users/me/photo The user photo. Get, post, and crop the photo.
/chatter/users/me/recommendations Returns the user, group, file, and record recommendations for the logged-in user.
/chatter/users/me/recommendations/action Returns the recommendations of the specified action for the logged-in user. For example, use this resource to get a list of records to follow.
/chatter/users/me/recommendations/action/objectCategory Returns the recommendations of the specified action and object category for the logged-in user. Also used to delete recommendations.
/chatter/users/me/recommendations/action/idPrefix Returns the recommendations of the specified action and key prefix for the logged-in user.
/chatter/users/me/recommendations/action/objectID Returns the recommendation of the specified action and object ID for the logged-in user. Also used to delete a recommendation.
/chatter/users/me/records/recent A list of the records the logged-in user has recently added, edited, or viewed.
/chatter/users/me/settings Information about the context user’s global Chatter settings.
/chatter/users/me/status Returns the most recent user status feed item. Also used to update or delete user status.
/chatter/users/me/topics Topics recently used by the specified user. Get up to five topics most recently used by the specified user.