Set external battery mode

POST

/batterymode/{batteryMode}

const url = 'https://demo.evcc.io/api/batterymode/unknown';
const options = {method: 'POST'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url https://demo.evcc.io/api/batterymode/unknown

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.

Parameters

Path Parameters

batteryMode

required

Battery operation mode.

string

Allowed values: unknown normal hold charge holdcharge

Responses

200

Battery mode

application/json

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

integer

<= 4

Set external battery mode

Parameters

Path Parameters

Responses

200

Examplegenerated

Example^generated