v4

latestOpenAPI 3.1.02026-08-01207318738.7 KB

List 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.

get/api/v1/ai/conversations

Query parameters

cursorstring

Cursor for pagination (from previous response nextCursor)

Example:eyJpZCI6IjEyMzQ1In0

Cursor for pagination (from previous response nextCursor)

pageSizeinteger

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

Example:20

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

userIdstring uuid

Target user membership 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"
    }
  ]
}