---
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` 'unknown' | 'normal' | 'hold' | 'charge' | 'holdcharge', required — Battery mode

## Response `200`

Battery mode

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

## Changes

- **2026-07-20** `32e824ccacfe` — 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-06-09** `347e67943b4b` — 1 breaking, 1 info
  - the `result` response property's max was increased from `3.00` to `4.00` for the response status `200`
  - added the new enum value `holdcharge` to the `path` request parameter `batteryMode`
- **2025-08-10** `c4027a2cb484` — 1 info
  - api operation id `setExternalBatteryMode` was added
- **2025-08-01** `2429e9297a5c` — 1 breaking, 1 info
  - removed the enum value `holdcharge` from the `path` request parameter `batteryMode`
  - api operation id `setExternalBatteryMode` removed and replaced with ``

[Change 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/32e824ccacfe/schema)