---
title: "Opt-in anonymized flexibility telemetry"
method: POST
path: "/v1/telemetry/flex"
---

# Opt-in anonymized flexibility telemetry

`POST /v1/telemetry/flex`

## Request

- Base URL: `https://voltcast.com/api`
- URL: `https://voltcast.com/api/v1/telemetry/flex`
- Auth: HTTP bearer

## Request body

- object
  - `zone` string, required
  - `device_type` 'ev' | 'battery' | 'heatpump' | 'appliance' | 'other', required
  - `planned_start` string, date-time, required
  - `planned_end` string, date-time, required
  - `energy_kwh` number
  - `trigger` 'cheapest_window' | 'price_threshold' | 'schedule' | 'manual', required

## Response `201`

Recorded. No PII; aggregates published only above a 25-reporter k-anonymity floor (GET /v1/telemetry/flex/stats).

---

[API](https://skmtc.dev/voltcast/apis/voltcast-api.md) · [All operations](https://skmtc.dev/voltcast/apis/voltcast-api/llms.txt) · [OpenAPI document](https://skmtc.dev/voltcast/apis/voltcast-api/revisions/9c39e52e3eed?raw)