Delete energy metrics

DELETE

/db/metrics/energy

const url = 'https://demo.evcc.io/api/db/metrics/energy?from=2026-07-01T00%3A00%3A00Z&to=2026-07-02T00%3A00%3A00Z&group=forecast&name=db%3A8&title=Battery';
const options = {method: 'DELETE', headers: {cookie: 'auth=<auth>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request DELETE \
  --url 'https://demo.evcc.io/api/db/metrics/energy?from=2026-07-01T00%3A00%3A00Z&to=2026-07-02T00%3A00%3A00Z&group=forecast&name=db%3A8&title=Battery' \
  --cookie auth=<auth>

Deletes recorded energy slots in the given time range, optionally narrowed by entity. Filter parameters match /history/energy, so the same request can be previewed there before deleting. Session users must supply the admin password in the X-Admin-Password header. API key holders via Bearer token are exempt.

Authorizations

cookieAuth
bearerAuth

Parameters

Header Parameters

X-Admin-Password

Admin password

string

Admin password (required for session auth, not needed for API key)

Query Parameters

from

required

string format: date-time

Example

2026-07-01T00:00:00Z

Start time, inclusive (RFC3339)

required

string format: date-time

Example

2026-07-02T00:00:00Z

End time, exclusive (RFC3339)

group

string

Allowed values: forecast battery grid pv home loadpoint meter consumer temperature

Example

forecast

Filter by entity group

name

string

Example

db:8

Filter by entity name

title

string

Example

Battery

Filter by entity title

Responses

200

Success - number of deleted records

application/json

object

deleted

integer

Example

{
  "deleted": 96
}

400

Invalid parameters or database offline

401

Unauthorized - Login and try again

text/plain

string

Allowed values: Unauthorized