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

# List AI conversations

`GET /v1/ai/conversations`

List a user's recent AI conversations, ordered by most-recent activity. Each conversation includes an ID that can be passed as `conversationId` to subsequent [Create AI job](/api/ai/create-ai-job) requests to continue the thread.

Returns a paginated list with conversation metadata including optional names and the most recent user prompt for display purposes.

## Query parameters

- `userId` string, uuid
- `pageSize` integer
- `cursor` string

## Response `200`

Successfully retrieved conversations

- object
  - `data` object[], required — List of AI conversations
    - `id` string, uuid, required — Unique identifier for the conversation. Pass this as `conversationId` when creating AI jobs to continue the thread.
    - `name` string, nullable — Optional name for the conversation. May be `null` if no name has been set.
    - `lastUserPrompt` string, nullable — The most recent user prompt in the conversation, suitable for display as a one-line summary. May be `null` for empty conversations.
    - `updatedAt` string, date-time, required — Timestamp of the most recent activity in the conversation in ISO 8601 format.
    - `createdAt` string, date-time, required — Timestamp when the conversation was created in ISO 8601 format.
  - `pageInfo` PageInfo, required — Pagination information for paginated responses.
    - `hasNextPage` boolean — Indicates if there are more records available.
    - `nextCursor` string, nullable — Cursor for the next page of results. `null` if no more results.
    - `pageSize` integer — Number of records per page.
    - `totalRecords` integer — Total number of records matching the query.

## Other responses

- `400` — Bad Request Possible error messages: - `Invalid userId format` - `userId` must be a valid UUID - `Invalid pageSize` - `pageSize` must be an integer between 1 and 100 - `Invalid nextCursor` - pagination `cursor` is malformed
- `403` — Forbidden Possible error messages: - `Insufficient permissions` - User lacks ability to use AI on any model in the organization - `User-scoped tokens cannot filter by userId` - Personal Access Tokens cannot use the `userId` parameter
- `404` — Not Found Possible error messages: - `User not found` - the specified `userId` does not exist in the organization
- `429` — Too Many Requests - Rate limit exceeded (60 requests/minute)
- `500` — Internal Server Error

---

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