Moves one or more cost centers to a new parent cost center in the organizational hierarchy
Use this endpoint to reorganize cost centers within the tree. Accepts a list of cost center IDs to move
under the specified parent. Cost centers already under the target parent are skipped (not counted as updated).
This is a bulk operation — the response indicates how many were selected vs. how many were actually moved.
Validation ensures no circular parent references are created.
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 |
|---|---|---|---|
| parentCostCenterId | The unique numeric identifier of the destination cost center that will become the new parent | integer (int32) | Required |
Request Body
Array of:
Type: integer (int32)
Example Request Body
[
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
{ "selected": 1, "updated": 1
}
404
Not Found
The requested resource was not found. Verify the ID or path is correct.