---
title: "Set external battery mode"
method: POST
path: "/batterymode/{batteryMode}"
tags: ["battery"]
---

# Set external battery mode

`POST /batterymode/{batteryMode}`

Directly controls the mode of all controllable batteries. evcc behavior like 'price limit' or 'prevent discharge while fast charging' is overruled. External mode resets after 60s. The external system has to call this endpoint regularly.

## Path parameters

- `batteryMode` BatteryMode, required — unresolved $ref

## Response `200`

Battery mode

- integer — Battery mode. 0: unknown, 1: normal, 2: hold, 3: charge, 4: holdcharge

## Changes

> 37 revisions in range; 1 could not be searched.

- **2026-08-03** `c75ef6921f05` — 5 breaking, 1 info
  - removed the enum value `charge` from the `path` request parameter `batteryMode`
  - removed the enum value `hold` from the `path` request parameter `batteryMode`
  - removed the enum value `holdcharge` from the `path` request parameter `batteryMode`
  - removed the enum value `normal` from the `path` request parameter `batteryMode`
  - …2 more
- **2026-07-24** `e84dc2eafd11` — 1 breaking, 6 info
  - the `path` request parameter `batteryMode` was restricted to a list of enum values
  - added the new enum value `charge` to the `path` request parameter `batteryMode`
  - added the new enum value `hold` to the `path` request parameter `batteryMode`
  - added the new enum value `holdcharge` to the `path` request parameter `batteryMode`
  - …3 more
- **2026-07-23** `46689b886c53` — 1 breaking, 1 warning
  - the response's body type/format changed from `object`/`` to `integer`/`` for status `200`
  - removed the optional property `result` from the response with the `200` status
- **2026-07-23** `5f032b4182a7` — 6 breaking, 2 info
  - removed the enum value `charge` from the `path` request parameter `batteryMode`
  - removed the enum value `hold` from the `path` request parameter `batteryMode`
  - removed the enum value `holdcharge` from the `path` request parameter `batteryMode`
  - removed the enum value `normal` from the `path` request parameter `batteryMode`
  - …4 more
- …earlier changes not shown

[Full history](https://skmtc.dev/evcc-io/apis/evcc/changes/batterymode/:batteryMode/post.md)

---

[API](https://skmtc.dev/evcc-io/apis/evcc.md) · [All operations](https://skmtc.dev/evcc-io/apis/evcc/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/evcc-io/evcc/revisions/5152af83a070/schema)