---
title: "Get conversation messages"
method: POST
path: "/dashboard/api/conversation-messages"
tags: ["Conversations"]
---

# Get conversation messages

`POST /dashboard/api/conversation-messages`

## Request

- Base URL: `https://api.agnost.ai`
- URL: `https://api.agnost.ai/dashboard/api/conversation-messages`
- Auth: one of:
  - HTTP bearer and API key in header `x-org-id`
  - API key in header `x-api-key`

## Request body

- object
  - `conversation_id` string, uuid, required
  - `time_range` string: Optional reporting window applied to conversation events.
  - `page` integer
  - `limit` integer: Event rows per page; explicitly supplied values are capped at 100.
  - `load_io` boolean: Resolves readable input/output message content when true.

## Response `200`

Conversation messages, with multimodal text/image_url content encoded in versioned message strings

- object
  - `conversation_id` string, uuid, required
  - `timestamp` string, date-time, required
  - `user_id` string, required
  - `messages` object[], required
    - `id` string
    - `role` string
    - `timestamp` string, date-time
    - `latency` integer
    - `success` boolean
    - `message` string
  - `total_messages` integer, required: Number of rendered messages in this page.
  - `has_more` boolean, required: True when another event page is available for the same query.

## Changes

- **2026-11-03** `a61431b48f36`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/agnost/apis/agnost-ai-api/changes/dashboard/api/conversation-messages/post.md)

---

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