---
title: "Get Conversation"
method: GET
path: "/api/v1/ollie/projects/{project_id}/conversation"
tags: ["ollie"]
---

# Get Conversation

`GET /api/v1/ollie/projects/{project_id}/conversation`

Load paginated conversation messages for a project.

The newest page (no cursor) returns the most recent ``limit`` messages
in chronological order; ``has_more`` signals older messages exist beyond
the window. Subsequent pages pass ``before_id`` to walk backwards.

Ordering keys off ``(created_at, id)`` both for the windowing SQL and
the cursor comparison (eng-review #4c — deterministic under equal
timestamps).

## Path parameters

- `project_id` string, uuid, required

## Query parameters

- `before_id` string, uuid, nullable — Fetch messages older than this message id
- `limit` integer

## Response `200`

Successful Response

- AgentConversationPageResponse — Paginated conversation response. Messages are returned in chronological (oldest-first) order within the page. ``has_more`` tells the caller whether an older page exists beyond the current window (fetched via ``before_id``).
  - `id` string, uuid, required
  - `project_id` string, uuid, required
  - `muted` boolean, required
  - `message_count` integer, required
  - `messages` AgentConversationMessageResponse[], required
    - `id` string, uuid, required
    - `conversation_id` string, uuid, required
    - `role` 'user' | 'ollie' | 'system', required
    - `content` string, required
    - `tool_calls` object[], required
    - `citations` Citation[], required
      - `type` 'web' | 'internal_ref' | 'tool_result' | 'lookup', required
      - `title` string, required
      - `url` string, nullable
      - `source_id` string, nullable
      - `section` string, nullable
      - `snippet` string, nullable
      - `confidence` 'definitive' | 'confident' | 'hedged' | 'unknown', required
    - `model_used` string, nullable
    - `created_at` string, date-time, required
    - `user_feedback` 'up' | 'down', nullable
    - `trace_id` string, uuid, nullable
  - `has_more` boolean, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/prototyping/apis/prototyping-io-api.md) · [All operations](https://skmtc.dev/prototyping/apis/prototyping-io-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/prototyping/prototyping-io-api/revisions/f4a0079fbb57/schema)