Chatter REST API Developer Guide
jNewer Version Available
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 context or specified user's Chatter profile. |
| /chatter/users/batch/user_list | Returns information about the specified users’ profiles. |
| /chatter/users/userId/activities/export-job | Export Chatter-related activity, such as bookmarks, topic endorsements, and votes, for a user. |
| /chatter/users/userId/activities/purge-job | Start a job to purge Chatter-related activity, such as bookmarks, topic endorsements, and votes, for a user. |
| /chatter/users/me/conversations | Returns all private conversations for the context user. Also used to search across all conversations. |
| /chatter/users/me/conversations/conversationId | Returns information about a private conversation for the context user. Also used to search within a conversation and to change the status of a conversation. |
| /chatter/users/me/conversations/conversationId/mark-read | Changes the status of a conversation. |
| /chatter/users/me/conversations/unread-count | Returns the number of conversations that have unread messages for the context or specified user. |
| /connect/files/users/me | Upload a file, including references to external files, to the Files home 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. |
| /connect/files/users/me/filter/groups | Returns information about files posted to groups that the specified user is a member of. |
| /connect/files/users/me/filter/shared-with-me | 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 | Get the groups that a 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 context 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 | Get the Chatter recommendations, such as user, group, file, record, topic, and article recommendations, for the context user. Also get custom and static recommendations for the context user. |
| /chatter/users/me/recommendations/action | Get the Chatter, custom, and static recommendations for the specified action for the context user. |
| /chatter/users/me/recommendations/action/objectCategory | Get the Chatter, custom, and static recommendations for the specified action and object category for the context user. |
| /chatter/users/me/recommendations/action/idPrefix | Get the Chatter, custom, and static recommendations for the specified action and key prefix for the context user. |
| /chatter/users/me/recommendations/action/objectID | Get the Chatter, custom, and static recommendations for the specified action and object ID for the context user. Also used to delete a recommendation. |
| /chatter/users/userId/recommendations/action/objectEnum | Get the static Chatter recommendation for the specified action and object type for the context user. Also used to delete a static recommendation. |
| /connect/communities/communityId/chatter/users/userId/reputation | Returns the specified community user's reputation. |
| /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 | Get up to five topics most recently used by a user. |