---
title: "Delete energy metrics"
method: DELETE
path: "/db/metrics/energy"
tags: ["db"]
---

# Delete energy metrics

`DELETE /db/metrics/energy`

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.

## Query parameters

- `from` string, date-time, required
- `to` string, date-time, required
- `group` 'forecast' | 'battery' | 'grid' | 'pv' | 'home' | 'loadpoint' | 'meter' | 'consumer' | 'temperature'
- `name` string
- `title` string

## Headers

- `X-Admin-Password` string — Admin password

## Response `200`

Success - number of deleted records

- object
  - `deleted` integer

## Other responses

- `400` — Invalid parameters or database offline
- `401` — Unauthorized - Login and try again

---

[API](https://skmtc.net/evcc-io/apis/evcc.md) · [All operations](https://skmtc.net/evcc-io/apis/evcc/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/evcc-io/evcc/versions/1d484c790b11/schema)