---
title: "List conversations"
method: GET
path: "/conversations"
tags: ["conversations"]
---

# List conversations

`GET /conversations`

List the caller's conversations (most recently updated first, excluding deleted ones).

Required roles: All, App

## Query parameters

- `limit` integer
- `offset` integer
- `principal_id` string
- `all_principals` boolean

## Response `200`

Conversation list

- ConversationListResponse
  - `conversations` Conversation[], required
    - `id` string, required
    - `principal_id` string, nullable — Authorization principal this conversation belongs to (null if not set).
    - `title` string, nullable
    - `current_leaf_id` string, nullable
    - `created_at` string, date-time
    - `updated_at` string, date-time

## Other responses

- `400` — Bad Request (e.g. principal_id combined with all_principals=true)
- `401` — Unauthorized

---

[API](https://skmtc.net/qlonolink/apis/qaip-apis.md) · [All operations](https://skmtc.net/qlonolink/apis/qaip-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/qlonolink/qaip-apis/revisions/f5f5994dfe05/schema)