View my direct message list

See a list of members with who you have exchanged direct messages.

Method

GET

URL

https://typetalk.com/api/v2/messages

Scope

my

Query parameters

Response Example

{
    "topics": [
        {
            "topic": {
                "id": 26094,
                "name": "Moss,Jessica",
                "suggestion": "Moss,Jessica",
                "isDirectMessage": true,
                "isArchived": false,
                "lastPostedAt": "2019-08-30T10:21:27Z",
                "createdAt": "2019-08-30T10:21:27Z",
                "updatedAt": "2019-08-30T10:21:27Z"
            },
            "unread": {
                "topicId": 26094,
                "postId": 176258,
                "count": 0,
                "isOverCountLimit": false
            },
            "directMessage": {
                "account": {
                    "id": 2499,
                    "name": "Moss",
                    "fullName": "Moss",
                    "suggestion": "Moss",
                    "imageUrl": "https://typetalk.com/accounts/2499/profile_image.png?t=1453891379196",
                    "isBot": false,
                    "createdAt": "2016-01-27T09:55:23Z",
                    "updatedAt": "2019-09-09T02:35:18Z"
                },
                "status": {
                    "presence": "active",
                    "web": {},
                    "mobile": null
                },
                "userStatus": {
                    "id": 130,
                    "accountId": 2499,
                    "spaceId": 34,
                    "emoji": ":train:",
                    "message": "In transit",
                    "clearAt": "2019-09-09T03:35:00Z",
                    "isNotificationDisabled": false,
                    "createdAt": "2019-09-09T02:35:39Z",
                    "updatedAt": "2019-09-09T02:35:39Z"
                }
            }
        },
        {
            "topic": {
                "id": 3917,
                "name": "Jessica,StefHull",
                "suggestion": "Jessica,StefHull",
                "isDirectMessage": true,
                "isArchived": false,
                "lastPostedAt": "2018-11-26T01:09:12Z",
                "createdAt": "2016-07-06T02:51:03Z",
                "updatedAt": "2016-08-17T08:30:58Z"
            },
            "unread": {
                "topicId": 3917,
                "postId": 168196,
                "count": 0,
                "isOverCountLimit": false
            },
            "directMessage": {
                "account": {
                    "id": 2498,
                    "name": "Stefanie",
                    "fullName": "Stefanie",
                    "suggestion": "Stefanie",
                    "imageUrl": "https://typetalk.com/accounts/2498/profile_image.png?t=1453891479138",
                    "isBot": false,
                    "createdAt": "2016-01-27T09:55:09Z",
                    "updatedAt": "2019-09-04T06:57:51Z"
                },
                "status": {
                    "presence": "away",
                    "web": null,
                    "mobile": null
                },
                "userStatus": null
            }
        }
    ]
}

All responses are formatted in JSON and include an ETag. If you call an API with an If-None-Match header, the server will return a 304 status code if the data is unchanged. The date and time format is ISO 8601, and the timezone is UTC (eg. 2014-01-09T06:20:08Z).