Persists a reporting-chat exchange and generates KQL for querying report data
Use this endpoint for initial report prompts, refinements, and clarification selections. It persists the displayed user content and one assistant response but does not create or update a dynamic report. Execute successful KQL through the dynamic-report query endpoint and save explicitly through the dynamic-report endpoints.
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, including the request body. |
Path Parameters
| Name | Description | Type | Required |
|---|---|---|---|
| chatId | Unique numeric identifier of an active reporting chat owned by the authenticated user | integer (int32) | Required |
Request Body
WattsReportChatMessageCreate
| Property | Description | Type |
|---|---|---|
| clarificationOptions | Clarification options shown to the user. Null when no options were presented or this message is not a clarification response. | string[] |
| clarificationOriginalPrompt | Original user-facing prompt that produced a clarification question. Null when this message is not a clarification response. | string |
| clarificationQuestion | Clarification question shown to the user. Null when this message is not a clarification response. | string |
| content | User-facing message persisted verbatim in reporting chat history. Required | string |
| priorKql | KQL for the currently displayed report when this message refines an existing result. Null for an initial report request. | string |
Example Request Body
{ "clarificationOptions": [
"string"
], "clarificationOriginalPrompt": "string", "clarificationQuestion": "string", "content": "string", "priorKql": "string"
}
Responses
200
OK
The request succeeded and the response body contains the requested data.
Response Body Parameters
WattsReportResultEvent
| Property | Description | Type | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| result | WattsReportChatResponse | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
WattsReportChatResponse properties
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| type | string | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Example Response
{ "result": { "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": []
}
], "clarificationOptions": [
"string"
], "clarificationQuestion": "string", "error": "string", "explanation": "string", "isAnswerOnly": false, "isSuccess": false, "kql": "string", "requiresClarification": false, "resolutionSteps": [
"string"
], "userMessageId": 1, "wattsChatMessageId": 1
}, "type": "string"
}
404
Not Found
The requested resource was not found. Verify the ID or path is correct.