GET /api/v202510/energymanager/chat/{chatId}/message

Retrieves all messages in a Watts chat session

GetUserChatMessagesV202510

Use this endpoint to get the full conversation history for a chat. Returns messages in chronological order. The chat must be active (not deleted) and belong to the authenticated user. Requires the VirtualEnergyManager feature flag.

Request Headers

Header	Value	Required	Description
ECI-ApiKey	string	Yes	Your API key. See Authentication.
Content-Type	application/json	Yes	All requests must specify JSON content type.

Path Parameters

Name	Description	Type	Required
chatId	Unique numeric identifier of the chat	integer (int32)	Required

Responses

200 OK The request succeeded and the response body contains the requested data.

Response Body Parameters

Array of:

WattsChatMessageResponseV202510

Property Description Type

citations Data queries run to produce this message, in the order they ran. Empty for user messages, for assistant replies that needed no query, and for history recorded before citations were captured. WattsChatCitationV202510[]

WattsChatCitationV202510 properties

Property Description Type

callId Identifies the citation within its turn. Stable across a reload, because the stored citations keep the order they ran in. string

chart WattsChatChartV202510

WattsChatChartV202510 properties

Property Description Type

chartType Chart kind: columnchart, barchart, linechart, piechart, and so on. string

columns Column names, in result order. WattsChatChartColumnV202510[]

WattsChatChartColumnV202510 properties

Property	Description	Type
dataType	Logical type, used for axis formatting.	string
name		string

kind Optional sub-kind, such as stacked. string

rows Rows, each aligned positionally to EnergyCap.DTO.V202510.WattsChatChartDTO.Columns. array[]

truncated True when more rows matched than were carried for drawing. boolean

xColumn Explicit category (x-axis) column, when the query named one. string

yColumns Explicit value (y-axis) columns, when the query named them. string[]

detail The citable artifact itself: the KQL text, the API method and path, the search phrase, or the expression that was evaluated. string

documentationUrl Public documentation for what was called. Set for API citations; null otherwise. string

emptyReason Why a query that ran fine returned nothing. Null unless the result was empty. string

error Why the call failed, when it did. A failed call is still cited — showing what was attempted explains a thin answer better than silence. string

filters The filters the query applied, as a reader would say them. Lets an answer state what it covered without anyone reading KQL. string[]

kind One of the EnergyCap.DTO.V202510.WattsChatCitationKind values. string

queryTimeMs How long the work took, in milliseconds, when the tool reports it. integer (int64)

rowCount Rows or records returned. Null when the call failed or returned no count. integer (int32)

running Whether this call is still running. A citation is emitted when the call starts and again when it finishes, so a slow query shows what is being waited on rather than an unexplained spinner. boolean

summary A short plain-language outcome shown beside the citation, when one adds anything — for example the value a calculation produced. string

toolName Name of the tool that ran, e.g. run_kql or call_energycap_api. string

truncated True when more data matched than was returned. boolean

warnings Problems with the query worth telling the user about — a result built from an arbitrary sample, for instance. Empty when there is nothing to say. string[]

content Full message content string

createdDate Date/time offset representing when Watts chat message was sent string (date-time)

inputTokens Tokens this message cost. Null for user messages and for anything recorded before usage was captured. integer (int32)

messageKind Message kind. 0-Standard for ordinary messages, 1-Undo for the assistant message recording that the most recent report change was reverted (its content is the restored version’s summary). Only reporting chats record undos, so general chat messages are always Standard. Must be a valid value for WattsChatMessageKind: Standard = 0, Undo = 1 integer (int32)

outputTokens integer (int32)

totalTokens integer (int32)

wattsChatMessageId The identifier for the Watts chat message integer (int32)

wattsChatMessageRole Watts chat message role. 1-User, 2-Assistant, 3-Error. Must be a valid value for WattsChatMessageRole: User = 1, Assistant = 2, Error = 3 integer (int32)

Example Response application/json

[
  {    "citations": [
      {      "callId": "string",      "chart": {},      "detail": "string",      "documentationUrl": "string",      "emptyReason": "string",      "error": "string",      "filters": [],      "kind": "string",      "queryTimeMs": 1,      "rowCount": 1,      "running": false,      "summary": "string",      "toolName": "string",      "truncated": false,      "warnings": []
    }
    ],    "content": "string",    "createdDate": "2026-10-25",    "inputTokens": 1,    "messageKind": 1,    "outputTokens": 1,    "totalTokens": 1,    "wattsChatMessageId": 1,    "wattsChatMessageRole": 1
  }
]