v

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-09752661.9 KB
db

Delete energy metrics

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.

delete/db/metrics/energy

Query parameters

fromstring date-time required
Example:2026-07-01T00:00:00Z

Start time, inclusive (RFC3339)

tostring date-time required
Example:2026-07-02T00:00:00Z

End time, exclusive (RFC3339)

group'forecast' | 'battery' | 'grid' | 'pv' | 'home' | 'loadpoint' | 'meter' | 'consumer' | 'temperature'
Example:forecast

Filter by entity group

namestring
Example:db:8

Filter by entity name

titlestring
Example:Battery

Filter by entity title

Headers

X-Admin-Passwordstring

Admin password

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

Response

Success - number of deleted records

deletedinteger

Example response

{
  "deleted": 96
}