PUT /api/v3/meter/{meterId}/group

Replaces a meter's manual group memberships with the provided list

EditMeterGroupMembershipV3 Permissions: BuildingAndMeterGroups (Edit)
Use this endpoint to set the complete list of manual groups a meter belongs to. All groups passed in become the meter’s memberships; omitted groups are removed. Auto groups (including user-defined auto groups) cannot be modified through this endpoint.

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
meterId Unique numeric identifier of the meter integer (int32) Required

Request Body

Array of:

MeterGroupMember
Property Description Type
includeInCharts Whether to include this meter in the group’s benchmark charts Required (defined) boolean
meterGroupId The meter group this meter will belong to Required (defined) integer (int32)
Example Request Body application/json 
[
  {    "includeInCharts": false,    "meterGroupId": 1
  }
]

Responses

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

Response Body Parameters

Array of:

MeterGroupResponse
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)
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
Example Response application/json 
[
  {    "autoGroup": false,    "lastUpdated": "2026-06-29",    "meterGroupCategory": {      "meterGroupCategoryCode": "string",      "meterGroupCategoryId": 1,      "meterGroupCategoryInfo": "string"
    },    "meterGroupCode": "string",    "meterGroupId": 1,    "meterGroupInfo": "string",    "userDefinedAutoGroup": false
  }
]
404 Not Found The requested resource was not found. Verify the ID or path is correct.