AI

List AI conversations

Changed on

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, a one-line summary of the most recent prompt for display, and the user ID of the person it belongs to. Paginated via opaque pageInfo.nextCursor — pass it back as cursor to fetch the next page.

get/api/v1/ai/conversations

Request

  • Base URL
    https://omniapp.co (the document declares no server; this is the origin it was published from)
  • URL
    https://omniapp.co/api/v1/ai/conversations
  • Auth
    HTTP bearer

Query parameters

cursorstring

Cursor for pagination (from previous response nextCursor)

Example:eyJpZCI6IjEyMzQ1In0
pageSizeinteger

Number of results per page (1-100, integer)

Example:20
userIdstring uuid

Target user ID (for org-scoped API keys)

Response

Paginated list of conversations.

Example response

{
  "records": [
    {
      "createdAt": "2025-01-15T10:00:00.000Z",
      "id": "660e8400-e29b-41d4-a716-446655440001",
      "lastPrompt": "What were our top products last week?",
      "name": "Top products last week",
      "updatedAt": "2025-01-15T10:01:30.000Z",
      "userId": "770e8400-e29b-41d4-a716-446655440002"
    }
  ]
}

Changes