---
title: "Messages in one thread"
method: GET
path: "/v1/conversations/{id}/messages"
tags: ["Messages"]
---

# Messages in one thread

`GET /v1/conversations/{id}/messages`

## Request

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

## Path parameters

- `id` string, required

## Query parameters

- `account` string, required
- `cursor` string
- `limit` integer

## Response `200`

Success

- object
  - `items` Message[]
    - `id` string
    - `text` string
    - `createdAt` string, date-time
    - `from` SocialActor
      - `handle` string
      - `displayName` string, nullable
      - `avatarUrl` string, nullable
      - `id` string, nullable: The network's own id, for follow/block/mute
    - `fromMe` boolean: True when you sent it, so callers never compare handles
    - `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.
  - `cursor` string, nullable

---

[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)