Skip to main content
GET
/
conversations
/
{conversationId}
/
messages
Get Conversation Messages
curl --request GET \
  --url https://be.datagol.ai/conversations/{conversationId}/messages \
  --header 'x-auth-token: <api-key>'
[
  {
    "id": 7902,
    "conversationId": "c920e1f5-2ac7-4f17-aed7-b260e464c022",
    "userId": 206,
    "userQuery": "Can you do a RFM analysis on this data?",
    "modelResponse": [
      {
        "code": null,
        "data": "Here’s the plan and step-by-step pseudo-code for the RFM analysis, followed by a complete, executable Python script...\n\n```python\nimport pandas as pd\nimport numpy as np...",
        "type": "TEXT",
        "state": null,
        "message": null,
        "metadata": null
      }
    ],
    "uiMetadata": null,
    "messageMetadata": {
      "chainId": "1762280699",
      "agentType": "NewPythonAgent",
      "workbookId": null,
      "executionData": [
        {
          "content": "<table class=\"dataframe dataframe\">\n  <thead>\n    <tr style=\"text-align: right;\">\n      <th>user_id</th>\n      <th>email</th>\n      <th>full_name</th>...",
          "response_type": "dataframe"
        },
        {
          "content": {
            "agent": "Expert Selector",
            "model": "o4-mini"
          },
          "response_type": "tool_start"
        },
        {
          "content": {
            "input": "Reasoning Effort: medium",
            "action": "Thinking"
          },
          "response_type": "tool_call"
        },
        {
          "content": "requires_dataset: true\nexpert: \"Data Analyst\"\nconfidence: 9",
          "response_type": "processing"
        }
      ]
    },
    "isPinned": false,
    "timestamp": "2025-11-04T18:24:59.695784Z",
    "feedback": null
  }
]

Authorizations

x-auth-token
string
header
required

For server-to-server or automated access, use a DataGOL Service Account key. Pass it via the x-auth-token header instead of Authorization: x-auth-token: <service-account-key>

Path Parameters

conversationId
string<uuid>
required

The unique UUID identifying the conversation thread.

Example:

"6718e680-194b-47fb-b8f6-029b35565b99"

Response

200 - application/json

A JSON array containing the message history list along with agent analytics metadata.

id
integer

Internal unique message identifier.

Example:

7902

conversationId
string<uuid>

Back-reference to the parent conversation UUID.

Example:

"c920e1f5-2ac7-4f17-aed7-b260e464c022"

userId
integer

The structural ID of the user authoring the text.

Example:

206

userQuery
string

The exact prompt raw input supplied by the user.

Example:

"Can you do some analysis on this data?"

modelResponse
object[]

Content block payload parts yielded by the processing model.

uiMetadata
object

Client UI specific flags or tracking configurations.

messageMetadata
object
isPinned
boolean

Flags whether this thread item was pinned in the interface.

Example:

false

timestamp
string<date-time>

Message generation window log timestamp.

Example:

"2025-11-04T18:24:59.695784Z"

feedback
object

User satisfaction feedback payload data.