Newer Version Available

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

User Conversations, General

Returns all private conversations for the context user. Also used to search across all conversations. See User Conversations, Specific and User Messages, General.

Resource
1/chatter/users/me/conversations
or
1/chatter/users/userId/conversations

userId must be the ID of the context user or the alias me.

Note

Available since version
23.0
Requires Chatter
Yes
HTTP methods
GET or HEAD
Request parameters for GET
Parameter Name Type Required or Optional Description Available Version
page String Optional A page token that indicates where retrieval begins. Get this token from the NextPageUrl property in the response body. 23.0
pageSize Integer Optional Specifies the number of items per page. Valid values are between 1 and 100. If you don't specify a size, the default is 25. 23.0
q String Optional Specifies the string to search. The search string must contain at least two characters, not including any wildcards. For more information about wildcards, see Wildcards. This parameter is optional.

The query parameter only searches message text bodies, not user names, titles, and so on.

Note

24.0
Response body
Conversation Summary Collection