POST /api/v3/meterGroup/{meterGroupId}/updateUserAutoGroup

Refreshes group membership for a specific user-defined auto group

RecalculateUserMeterAutoGroupMemebershipV3 Permissions: BuildingAndMeterGroups (Edit)
Use this endpoint to recalculate which meters belong to a specific user-defined auto group based on its current filter rules. Only works on user-defined auto groups, not system auto groups.

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
meterGroupId Unique numeric identifier of the user-defined auto group to refresh integer (int32) Required

Responses

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

Response Body Parameters

GroupMeterGroupResponse
Property Description Type
autoGroup Indicates if this meter group is an autogroup boolean
lastUpdated The last time a member was inserted, updated, or deleted from the group string (date-time)
limitMembersByTopmost Indicates if the meter group has been set limit the list of members by the user’s topmost boolean
memberCommodityCode The commodity code for the meters in this group - if all meters belong to the same commodity the commodity code will be used here if meters belong to different commodities, value will be “MULTIPLE” if this group has no meters, value will be "" string
memberCount The number of meters in this group integer (int32)
memberCountWithTopmost The number of meters within the currently authenticated user’s topmost integer (int32)
meterGroupCategory MeterGroupCategoryChild
MeterGroupCategoryChild properties
Property Description Type
meterGroupCategoryCode Short code for the category (e.g., “BY_BLDG_TYPE”) string
meterGroupCategoryId Unique numeric identifier of the meter group category integer (int32)
meterGroupCategoryInfo Descriptive name of the category string
meterGroupCode The meter group code string
meterGroupId The meter group identifier integer (int32)
meterGroupInfo The meter group info string
userDefinedAutoGroup Indicates if this meter group is an user defined auto group boolean
userDefinedAutoGroupFilters The filters applied to determine the members of a user defined auto group FilterResponse[]
FilterResponse properties
Property Description Type
availableOperator The list of available operators Required (defined) string[]
caption The caption of the filter Required (defined) string
dataFieldId The datafield identifier Required (defined) integer (int32)
dataType DataTypeResponse
DataTypeResponse properties
Property Description Type
dataTypeCode The data type code/short name Required (defined) string
dataTypeId The unique identifier for the data type (e.g., 1=boolean, 2=integer, 3=string, 4=double, 6=date, 12=select list, 13=URL) Required (defined) integer (int32)
dataTypeInfo The data type display name/description Required (defined) string
fieldId The field identifier Required (defined) integer (int32)
hidden Indicates if the filter is hidden Required (defined) boolean
operator The operator Required (defined) string
queryParameterName The Query parameter name Required (defined) string
recommended Indicates if the filter is recommended Required (defined) boolean
required Indicates if the filter is required boolean
value The value of the filter Required (defined) string
Example Response application/json 
{  "autoGroup": false,  "lastUpdated": "2026-06-29",  "limitMembersByTopmost": false,  "memberCommodityCode": "string",  "memberCount": 1,  "memberCountWithTopmost": 1,  "meterGroupCategory": {    "meterGroupCategoryCode": "string",    "meterGroupCategoryId": 1,    "meterGroupCategoryInfo": "string"
  },  "meterGroupCode": "string",  "meterGroupId": 1,  "meterGroupInfo": "string",  "userDefinedAutoGroup": false,  "userDefinedAutoGroupFilters": [
    {    "availableOperator": [
      "string"
    ],    "caption": "string",    "dataFieldId": 1,    "dataType": {      "dataTypeCode": "string",      "dataTypeId": 1,      "dataTypeInfo": "string"
    },    "fieldId": 1,    "hidden": false,    "operator": "string",    "queryParameterName": "string",    "recommended": false,    "required": false,    "value": "string"
  }
  ]
}
404 Not Found The requested resource was not found. Verify the ID or path is correct.