PUT /api/v3/place/{placeId}/group

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

EditPlaceGroupMembershipV3 Permissions: BuildingAndMeterGroups (Edit)

Use this endpoint to set a place’s group memberships. The provided list becomes the complete set of manual group memberships — all groups must be passed in. Passing one group means the place belongs to only that group. Auto groups (system-defined and user-defined) are unaffected by 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
placeId	Unique numeric identifier of the place whose memberships are being set	integer (int32)	Required

Request Body

Array of:

PlaceGroupMember

Property	Description	Type
includeInCharts	Whether to include this place in the group’s benchmark charts Required (defined)	boolean
placeGroupId	The place group this place will belong to Required (defined)	integer (int32)

Example Request Body application/json

[
  {    "includeInCharts": false,    "placeGroupId": 1
  }
]

Responses

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

Response Body Parameters

Array of:

PlaceGroupResponse

Property

Description

Type

autoGroup

Indicates if this place group is an autogroup

boolean

lastUpdated

The last time a member was inserted, updated, or deleted from the group

string (date-time)

placeGroupCategory

PlaceGroupCategoryChild

PlaceGroupCategoryChild properties

Property	Description	Type
placeGroupCategoryCode	The short code for the place group category	string
placeGroupCategoryId	The unique identifier for the place group category	integer (int32)
placeGroupCategoryInfo	The display name for the place group category	string

placeGroupCode

The place group code

string

placeGroupId

The place group identifier

integer (int32)

placeGroupInfo

The place group info

string

userDefinedAutoGroup

Indicates if this place group is an user defined auto group

boolean

Example Response application/json

[
  {    "autoGroup": false,    "lastUpdated": "2026-06-29",    "placeGroupCategory": {      "placeGroupCategoryCode": "string",      "placeGroupCategoryId": 1,      "placeGroupCategoryInfo": "string"
    },    "placeGroupCode": "string",    "placeGroupId": 1,    "placeGroupInfo": "string",    "userDefinedAutoGroup": false
  }
]

400 Bad Request The request was malformed or contains invalid parameters. Check the request body and query parameters.

404 Not Found The requested resource was not found. Verify the ID or path is correct.