PUT /api/v3/parentPlace/{parentPlaceId}/place

Moves one or more places to a new parent in the hierarchy

MovePlaceV3 Permissions: BuildingsAndOrganizations (Edit)
Use this endpoint to relocate places under a different parent organization or site. Triggers recalculation of user-defined auto groups and clears the place benchmark cache. Validation is handled by PlaceValidator to ensure valid parent-child relationships.

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
parentPlaceId Unique numeric identifier of the new parent place integer (int32) Required

Request Body

Array of:

Type: integer (int32)

Example Request Body application/json
[
  1
]

Responses

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

Response Body Parameters

UpdateResult
Property Description Type
selected The total number of items that were targeted by the bulk operation Required (defined) integer (int32)
updated The number of items that were actually modified (excludes items that already matched the target state) Required (defined) integer (int32)
Example Response application/json
{  "selected": 1,  "updated": 1
}
404 Not Found The requested resource was not found. Verify the ID or path is correct.