AI13

AI Credit Controls6

AI Credit Usage2

AI Eval12

AI Model Suggestions9

AI Routines6

API Tokens4

App downloads3

Apps8

Branches3

Color Palettes5

Connection environments3

Connections5

Content2

Content migration2

Content validator2

Dashboard downloads3

Dashboard filters2

dbt9

Document favorites3

Document labels3

Document permissions6

Documents16

Documents v27

Embed1

Folder favorites2

Folder labels1

Folder permissions5

Folders5

IP Allowlist2

Jobs1

Labels5

Model branches1

Model Git configuration7

Models17

Queries3

Schedule recipients6

Schedules10

Schema refresh schedules5

Skills5

Topics4

Uploads4

User attributes9

User group model roles2

User groups6

User model roles2

Users10

Who Am I1

Get conversation

Changed on Nov 3, 2026

Retrieve a conversation with its full message history — alternating user and assistant turns. Each assistant turn carries the originating jobId and an omniChatUrl deep link. userId identifies who the conversation belongs to, whether it started in the Omni UI or through the API.

The conversations returned by this API depend on the type of API key being used:

Organization API keys can access any conversation in the organization
Personal Access Tokens can only access the authenticating user's conversations

get/v1/ai/conversations/{conversationId}

Request

Base URL
https://blobsrus.omniapp.co/api
URL
https://blobsrus.omniapp.co/api/v1/ai/conversations/{conversationId}
Auth
HTTP bearer

Path parameters

conversationIdstring uuid required

The unique identifier of the conversation

Response

Conversation retrieved successfully

idstring uuid required

The unique identifier for this conversation.

namestring nullable required

Conversation title, set by the AI after the first turn. null on brand-new conversations.

userIdstring uuid required

User ID of the person the conversation belongs to.

createdAtstring date-time required

When the conversation was created.

updatedAtstring date-time required

When the conversation was last modified.

Example response

{
  "id": "660e8400-e29b-41d4-a716-446655440001",
  "name": "Top products last week",
  "userId": "770e8400-e29b-41d4-a716-446655440002",
  "createdAt": "2025-01-15T10:00:00.000Z",
  "updatedAt": "2025-01-15T10:01:30.000Z",
  "messages": [
    {
      "role": "user",
      "text": "What are the top 5 products by revenue?",
      "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"
    }
  ]
}

Changes

Nov 3, 202643290040f88f Revision changes
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  removed the required property // from the response with the status
- breaking
  removed the required property // from the response with the status
- breaking
  removed the required property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- info
  api operation id getConversation removed and replaced with aiConversationDetail
- info
  the response property // became required for the status
- info
  the response property // became required for the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status

Operation history