---
title: "Conversations Retrieve"
method: GET
path: "/agents/conversations/{id}/"
tags: ["agents"]
---

# Conversations Retrieve

`GET /agents/conversations/{id}/`

Retrieve, update, or delete a single conversation.

GET    /agents/conversations/<pk>/ — conversation + message tree
PATCH  /agents/conversations/<pk>/ — update title
DELETE /agents/conversations/<pk>/ — hard delete (CASCADE removes messages)

GET query params:
    branch_tip (str, optional): Message ID to walk from when
        reconstructing the active branch. If omitted, defaults to
        the most recent message. Messages not on the active branch
        are returned in ``orphaned_messages``.

## Path parameters

- `id` string, required

## Headers

- `Authorization` string, required

## Response `200`

- ConversationDetail
  - `id` string, required
  - `title` string, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `messages` Message[], required
    - `id` string, required
    - `role` string, required
    - `content` unknown, required
    - `parent_id` string, nullable, required
    - `created_at` string, date-time, required
    - `metadata` unknown, required
  - `orphaned_messages` Message[], required
    - `id` string, required
    - `role` string, required
    - `content` unknown, required
    - `parent_id` string, nullable, required
    - `created_at` string, date-time, required
    - `metadata` unknown, required
  - `truncated` boolean, required

---

[API](https://skmtc.net/keywordsai/apis/api-reference.md) · [All operations](https://skmtc.net/keywordsai/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/keywordsai/api-reference/versions/c26d550029f8/schema)