List Direct Messages

List all messages in a 1:1 (direct) room. Each message will include content attachments if present.

External Documentation

To learn more, visit the Cisco Webex documentation.

​

Basic Parameters

Parameter	Description
Group Or Direct	Choose to get direct messages with a person using their person ID or Email.
Person Email	The Email address of the person to list messages of. Can be retrieved from the List People action.
Person ID	The ID of the person to list messages of. Can be retrieved from the List People action.

​

Advanced Parameters

Parameter	Description
Parent ID	List messages with a parent, by the parent ID.

​

Example Output

{
	"items": [
		{
			"id": "Y2lzY29zcGFyazovL3VzL01FU1NBR0UvOTJkYjNiZTAtNDNiZC0xMWU2LThhZTktZGQ1YjNkZmM1NjVk",
			"parentId": "Y2lzY29zcGFyazovL3VzL01FU1NBR0UvOTJkYjNiZTAtNDNiZC0xMWU2LThhZTktZGQ1YjNkZmM1NjVk",
			"roomId": "Y2lzY29zcGFyazovL3VzL1JPT00vODQxZjY5MjAtNDdlZC00NmE0LWI2YmItZTVjM2M1YTc3Yzgy",
			"roomType": "direct",
			"text": "Hey there, what do you think of this project update presentation (http://sharepoint.example.com/presentation.pptx)?",
			"markdown": "Hey there, what do you think of [this project update presentation](http://sharepoint.example.com/presentation.pptx)?",
			"html": "<p>Hey there, what do you think of <a href=\\\"http://sharepoint.example.com/presentation.pptx\\\" rel=\\\"nofollow\\\">this project update presentation</a>?</p>",
			"files": [
				"http://www.example.com/images/media.png"
			],
			"personId": "Y2lzY29zcGFyazovL3VzL1BFT1BMRS9mNWIzNjE4Ny1jOGRkLTQ3MjctOGIyZi1mOWM0NDdmMjkwNDY",
			"personEmail": "[e-mail]",
			"attachments": [
				{
					"contentType": "application/vnd.microsoft.card.adaptive",
					"content": {
						"type": "AdaptiveCard",
						"version": "1.0",
						"body": [
							{
								"type": "TextBlock",
								"text": "Adaptive Cards",
								"size": "large"
							}
						],
						"actions": [
							{
								"type": "Action.OpenUrl",
								"url": "http://adaptivecards.io",
								"title": "Learn More"
							}
						]
					}
				}
			],
			"created": "2015-10-18T14:26:16+00:00",
			"updated": "2015-10-18T14:27:16+00:00",
			"isVoiceClip": false
		}
	]
}