---
title: "Messages of one conversation"
method: GET
path: "/v1/admin/conversations/{conversation_id}/messages"
tags: ["admin"]
---

# Messages of one conversation

`GET /v1/admin/conversations/{conversation_id}/messages`

## Request

- Base URL: `https://api.patricia.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.patricia.app/v1/admin/conversations/{conversation_id}/messages`
- Auth: HTTP bearer

The messages of one conversation, newest first. Each message has its role, author, time, run and full text with secrets removed. A conversation can be a private direct message between a person and Patricia. The read is recorded against your staff account.

## Path parameters

- `conversation_id` string, uuid, required: The conversation id.

## Query parameters

- `limit` integer: How many rows to return, 1 to 200. Defaults to 50.
- `pq` string, nullable: The page marker from the `next` or `previous` value of an earlier answer.
- `from_prev` boolean: True when the page marker came from `previous`.

## Response `200`

Successful Response

- ConversationMessages
  - `items` ConversationMessageItem[], required
    - `id` string, uuid, required
    - `role` string, required
    - `author` AdminActorRef, required
      - `id` string, uuid, required
      - `display_name` string, required
      - `unavailable` boolean
    - `created_at` string, date-time, required
    - `run_id` string, uuid, nullable, required
    - `content` string, nullable, required
  - `first` string, required
  - `next` string, nullable, required
  - `previous` string, nullable, required

## Other responses

- `422`: Validation Error

---

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