PUT /api/v202607/dynamicReporting/{reportId}

Updates a specific dynamic report by its ID. The report name and description can be changed, as well as the report body if desired. Returns 404 if the report does not exist.

UpdateDynamicReportV202607 Permissions: Reports (Run)

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
reportId integer (int32) Required

Request Body

DynamicReportRequestV202607
Property Description Type
kql The KQL that defines the data to be retrieved by the report Required (defined) string
reportDescription The description of the report Max length of 4000 Required (defined) string
reportName The report name Max length of 255 Required (defined) string
wattsChatMessageId The chat message ID associated with this version of the report, if applicable. Required (defined) integer (int32)
Example Request Body application/json 
{  "kql": "string",  "reportDescription": "string",  "reportName": "string",  "wattsChatMessageId": 1
}

Responses

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

Response Body Parameters

DynamicReportResponseV202607
Property Description Type
createdBy UserChild
UserChild properties
Property Description Type
fullName The user’s full name string
userCode The user code string
userId The user identifier integer (int32)
createdDate Date and time when the report was created. string (date-time)
description User-facing description stored on the current report version. Null when no description was supplied. string
dynamicReportId Unique numeric identifier of the saved dynamic report. integer (int32)
dynamicReportInfo User-facing saved report title. string
gridState Serialized grid, chart, and panel state stored on the current report version. Null when no UI state has been saved. string
kql KQL persisted on the current report version and used to reproduce its data. string
modifiedBy UserChild
UserChild properties
Property Description Type
fullName The user’s full name string
userCode The user code string
userId The user identifier integer (int32)
modifiedDate Date and time when the current report version was most recently modified. string (date-time)
ownerId Unique numeric identifier of the EnergyCAP owner that contains this report. integer (int32)
wattsChatId Unique numeric identifier of the reporting chat that owns the linked assistant message. Null for legacy or unlinked reports. integer (int32)
wattsChatMessageId Unique numeric identifier of the assistant message associated with the saved KQL. Null for legacy or unlinked reports. integer (int32)
Example Response application/json 
{  "createdBy": {    "fullName": "string",    "userCode": "string",    "userId": 1
  },  "createdDate": "2026-09-26",  "description": "string",  "dynamicReportId": 1,  "dynamicReportInfo": "string",  "gridState": "string",  "kql": "string",  "modifiedBy": {    "fullName": "string",    "userCode": "string",    "userId": 1
  },  "modifiedDate": "2026-09-26",  "ownerId": 1,  "wattsChatId": 1,  "wattsChatMessageId": 1
}
404 Not Found The requested resource was not found. Verify the ID or path is correct.