Permanently deletes an account-meter relationship, with an option to cascade-delete associated bills
Use this endpoint to remove the link between an account and meter. Cannot delete account-only records (where meterID is null).
This is irreversible and also removes associated rate and template assignments for this relationship.
Constraints for deleteBills=true: Only allowed when there is a single relationship between the specified account and meter,
and the user has bill delete permissions.
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 |
|---|---|---|---|
| accountMeterId | The unique numeric identifier of the account-meter relationship to delete | integer (int32) | Required |
Query Parameters
| Name | Description | Type | Required |
|---|---|---|---|
| deleteBills | When true, deletes all bills with at least one line for this account/meter combination. WARNING: The entire bill is deleted even if it includes other meters. When false, no bills are affected but deletion may fail if bills reference this relationship. | boolean | Optional |
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.