Skip to main content
GET
/
v1
/
ai
/
conversations
List AI conversations
curl --request GET \
  --url https://{instance}.omniapp.co/api/v1/ai/conversations \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "name": "Q1 Revenue Analysis",
      "lastUserPrompt": "Show me revenue trends by region for Q1",
      "updatedAt": "2026-05-15T14:32:10Z",
      "createdAt": "2026-05-15T09:15:30Z"
    },
    {
      "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
      "name": null,
      "lastUserPrompt": "What were our top selling products last month?",
      "updatedAt": "2026-05-14T16:20:45Z",
      "createdAt": "2026-05-14T16:20:45Z"
    }
  ],
  "pageInfo": {
    "hasNextPage": false,
    "nextCursor": null,
    "pageSize": 50,
    "totalRecords": 2
  }
}

Authorizations

​
Authorization
string
header
required

Can be either an Organization API Key or Personal Access Token (PAT).

Include in the Authorization header as: Bearer YOUR_TOKEN

Query Parameters

​
userId
string<uuid>

Requires an Organization API key. Filter conversations to a specific user by their membership ID.

User-scoped tokens automatically see only their own conversations and cannot use this parameter. Organization API keys can optionally filter by user or see all conversations in the organization.

​
pageSize
integer
default:50

Number of conversations to return per page.

Required range: 1 <= x <= 100
​
cursor
string

Pagination cursor from a previous response's pageInfo.nextCursor. Use to fetch the next page of results.

Response

Successfully retrieved conversations

​
data
object[]
required

List of AI conversations

​
pageInfo
object
required

Pagination information for paginated responses.