DELETE /api/v3/costcenter/{costCenterId}

Permanently deletes a cost center from the organizational hierarchy

DeleteCostCenterV3 Permissions: CostCenters (Delete)
Use this endpoint to remove a cost center node from the tree. Deletion fails if the cost center still has child cost centers or accounts assigned to it — those must be moved or deleted first. Also fails if the cost center is currently another user’s topmost node. This is an irreversible operation.

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.

Path Parameters

Name Description Type Required
costCenterId The unique numeric identifier of the cost center to delete integer (int32) Required

Responses

204 No Content The request succeeded. No content is returned in the response body.
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.