v4

latestOpenAPI 3.1.02026-08-01207318738.7 KB
AI

Get AI conversation with messages

Return a conversation with its full message history (alternating user / assistant turns). Used by clients (iOS app, embed widgets) to restore a prior conversation in their UI.

get/api/v1/ai/conversations/{conversationId}

Path parameters

conversationIdstring uuid required

Response

Conversation with messages in chronological order.

createdAtstring date-time required
idstring uuid required
namestring nullable required
updatedAtstring date-time required

Example response

{
  "messages": [
    {
      "createdAt": "2025-01-15T10:00:00.000Z",
      "jobId": "550e8400-e29b-41d4-a716-446655440000",
      "omniChatUrl": "https://my-org.omni.co/chat/660e8400-e29b-41d4-a716-446655440001",
      "role": "user",
      "text": "What were our top products last week?"
    }
  ]
}