---
title: "Direct message threads"
method: GET
path: "/v1/conversations"
tags: ["Messages"]
---

# Direct message threads

`GET /v1/conversations`

## Request

- Base URL: `https://api.postlake.dev`
- URL: `https://api.postlake.dev/v1/conversations`
- Auth: `bearerAuth` (a scheme the document does not define)

## Query parameters

- `account` string
- `cursor` string
- `limit` integer

## Response `200`

Success

- object
  - `items` Conversation[]
    - `id` string
    - `platform` string
    - `account` string
    - `inboxAccount` InboxAccountIdentity: The connected profile that receives this conversation and sends its replies.
      - `id` string, required
      - `handle` string, required
      - `displayName` string, nullable, required
      - `avatarUrl` string, nullable, required
    - `participants` SocialActor[]
      - `handle` string
      - `displayName` string, nullable
      - `avatarUrl` string, nullable
      - `id` string, nullable: The network's own id, for follow/block/mute
    - `lastMessage` object, nullable
      - `text` string
      - `createdAt` string, date-time
      - `fromMe` boolean
      - `content` MessageContent: A meaningful non-text direct-message payload. This is present for attachments, shared media, and message types the network does not expose in readable form. Do not treat an empty text field with this object as an empty message.
        - `kind` 'attachment' | 'shared_media' | 'unsupported', required
        - `label` string, required
        - `url` string, uri, nullable, required: Provider URL when available. Null means the provider withheld a destination.
    - `unreadCount` integer
  - `cursor` string, nullable: Opaque. Pass it back verbatim for the next page; null means the end. Never parse it: on cross-network reads it encodes a position per network.
  - `problems` ReadProblem[]
    - `account` string
    - `platform` string
    - `reason` string

---

[API](https://skmtc.dev/postlake/apis/postlake-api.md) · [All operations](https://skmtc.dev/postlake/apis/postlake-api/llms.txt) · [OpenAPI document](https://skmtc.dev/postlake/apis/postlake-api/revisions/f81060e31f69?raw)