Moves one or more accounts to a new parent cost center in the organizational hierarchy
Use this endpoint to reorganize accounts within the cost center tree. Accepts a list of account IDs to move
under the specified parent cost center. Accounts already under the target cost center are skipped (not counted as updated).
This is a bulk operation — the response indicates how many accounts were selected vs. how many were actually moved.
Does not modify the accounts’ other properties (vendor, code, status, etc.), only their parent cost center.
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 for the moved accounts | 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.