AIChatGetConversation¶

GET ai/chat/conversation

Returns the conversation, a page of its messages in chronological order, and activeRun — the generation that is still in progress.

activeRun is what an interface needs after a page reload: if it is not null, show the indicator and poll AIChatGetRun. Nothing else has to be reconstructed.

Access Control¶

Allowed: client, manager, admin. Only conversations of the current session.

Request¶

RESTTCPSDK

GET request

GET https://{broker_domain}/ai/chat/conversation?conversationId=cnv_8f3a…&limit=50
Authorization: <JWT_TOKEN>

{
  "command": "AIChatGetConversation",
  "extID": "1",
  "data": { "conversationId": "cnv_8f3a…", "limit": 50 }
}

const page = await platform.AIChatGetConversation({ conversationId, limit: 50 });

Parameters¶

Parameter	Type	Description
`conversationId`	string	Conversation id
`limit`	int	Messages per page, 1 to 200, default 50
`offset`	int	Messages to skip
`accountLogin`	int	Account context. Required for a client session of an account owner

Response Data¶

{
  "conversation": {
    "id": "cnv_8f3a…",
    "brand": "Ion",
    "agentId": 1,
    "title": "Margin call on 2000067",
    "accountLogin": 0,
    "archived": false,
    "createdAt": "2026-09-17 10:12:04",
    "updatedAt": "2026-09-17 10:12:40"
  },
  "messages": [
    {
      "id": "msg_1c7…",
      "conversationId": "cnv_8f3a…",
      "runId": "run_55b…",
      "role": "assistant",
      "content": "The position was closed by stop out…",
      "status": "completed",
      "model": "anthropic/claude-sonnet-4.5",
      "inputTokens": 1840,
      "outputTokens": 120,
      "cost": 0.0042,
      "metadata": { "sources": [], "actions": [], "toolCalls": [], "latencyMs": 4120 },
      "createdAt": "2026-09-17 10:12:40"
    }
  ],
  "count": 42,
  "activeRun": { "id": "run_9ad…", "state": "running" }
}

role is user or assistant. A failed answer is stored as a message too, so a question never stays on screen without a reaction.

Errors¶

Code	Error	Description
`403`	`AI_ACCESS_DENIED`	The session may not use the assistant
`404`	`AI_CONVERSATION_NOT_FOUND`	Unknown conversation, or one of another session