---
title: "List AI conversations"
method: GET
path: "/api/v1/ai/conversations"
tags: ["AI"]
---

# List AI conversations

`GET /api/v1/ai/conversations`

List the user's recent AI conversations, ordered by most-recent activity. Each record includes the conversation id (pass it back as `conversationId` on subsequent /api/v1/ai/jobs submissions to continue the thread), an optional name, and a one-line summary of the most recent prompt for display. Paginated via opaque `pageInfo.nextCursor` — pass it back as `cursor` to fetch the next page.

## Query parameters

- `cursor` string — Cursor for pagination (from previous response nextCursor)
- `pageSize` integer — Number of results per page (1-100, integer)
- `userId` string, uuid — Target user membership ID (for org-scoped API keys)

## Response `200`

Paginated list of conversations.

- AiConversationsListResponse
  - `pageInfo` PageInfo, required
    - `hasNextPage` boolean, required — Whether more results are available
    - `nextCursor` string, nullable, required — Cursor for fetching the next page
    - `pageSize` number, required — Number of results per page
    - `totalRecords` number, required — Total number of records matching the query
  - `records` AiConversation[], required — Conversations ordered by updatedAt descending.
    - `createdAt` string, date-time, required — When the conversation was started.
    - `id` string, uuid, required — Conversation ID. Pass as conversationId on subsequent /api/v1/ai/jobs submissions to continue this conversation.
    - `lastPrompt` string, nullable, required — The most recent user prompt in this conversation, useful for displaying a one-line summary in a list.
    - `name` string, nullable, required — Conversation title. Set by the AI after the first turn; null on brand-new sessions.
    - `updatedAt` string, date-time, required — When the conversation was last touched (most recent prompt or AI activity).

## Other responses

- `401` — Missing or invalid API key.
- `403` — Insufficient permissions.

---

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