Skip to main content
GET
/
api
/
dms
List DM conversations
curl --request GET \
  --url http://localhost:8091/api/dms \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "channel": {
        "id": "<string>",
        "name": "<string>",
        "displayName": "<string>",
        "topic": "<string>",
        "isDm": true,
        "isPrivate": true,
        "archived": true,
        "createdBy": "<string>",
        "createdAt": "2023-11-07T05:31:56Z",
        "position": 123,
        "serverId": "<string>",
        "memberCount": 123,
        "groupId": "<string>"
      },
      "otherUser": {
        "id": "<string>",
        "username": "<string>",
        "displayName": "<string>",
        "status": "<string>",
        "bot": true,
        "createdAt": "2023-11-07T05:31:56Z",
        "avatarPath": "<string>"
      },
      "lastMessage": {
        "id": "<string>",
        "channelId": "<string>",
        "userId": "<string>",
        "content": "<string>",
        "edited": true,
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z",
        "threadId": "<string>",
        "user": {
          "id": "<string>",
          "username": "<string>",
          "displayName": "<string>",
          "status": "<string>",
          "bot": true,
          "createdAt": "2023-11-07T05:31:56Z",
          "avatarPath": "<string>"
        },
        "replyCount": 123,
        "reactions": [
          {
            "emoji": "<string>",
            "count": 123,
            "users": [
              "<string>"
            ]
          }
        ],
        "attachments": [
          {
            "id": "<string>",
            "messageId": "<string>",
            "filename": "<string>",
            "storedPath": "<string>",
            "mimeType": "<string>",
            "sizeBytes": 123,
            "createdAt": "2023-11-07T05:31:56Z"
          }
        ]
      }
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Session token obtained from /api/auth/login or /api/auth/register. Pass as: Authorization: Bearer

Query Parameters

​
before
string

Cursor: return conversations with last activity before this ISO timestamp

​
limit
integer
default:30

Maximum number of conversations to return

Response

200 - application/json

DM conversations list

​
data
object[]