---
title: "Updates the current battery settings of a system"
method: PUT
path: "/api/v4/systems/config/{system_id}/battery_settings"
tags: ["System Configurations"]
---

# Updates the current battery settings of a system

`PUT /api/v4/systems/config/{system_id}/battery_settings`

## Request

- Base URL: `https://api-qa2.enphaseenergy.com`
- URL: `https://api-qa2.enphaseenergy.com/api/v4/systems/config/{system_id}/battery_settings`
- Auth: none declared
- TypeScript: <https://skmtc.dev/enphase/apis/monitoring-api/docs/api/v4/systems/config/:system_id/battery_settings/put.ts> (a function with typed inputs; its response is checked against the schema)

Updates the current battery settings of a system.

## Path parameters

- `system_id` string, required

## Request body

- object
  - `battery_mode` string: To update battery mode of the system (case sensitive) - "Savings Mode" / "Self-consumption" / "Full Backup"
  - `reserve_soc` integer: Reserve soc for the current mode - cannot be less than vls
  - `energy_independence` string: Energy independence after peak hours "enabled"/"disabled" . Enabled: Battery will discharge to save money during peak hours when electricity rates are high. Once that is done, energy independence is prioritized. This will increase the energy self-sufficiency until the reserve soc is hit. Battery will charge from solar in the morning to get ready for the next period Disabled: Battery will discharge only during peak hours when electricity rates are high. During other times, battery will be idle or will charge from solar in the morning to get ready for the next period

## Response `200`

OK

- object
  - `system_id` integer
  - `battery_mode` string: Current battery mode of the system
  - `reserve_soc` integer: Reserve soc for the current mode
  - `energy_independence` string: Energy independence after peak hours enabled/disabled . Enabled: Battery will discharge to save money during peak hours when electricity rates are high. Once that is done, energy independence is prioritized. This will increase the energy self-sufficiency until the reserve soc is hit. Battery will charge from solar in the morning to get ready for the next period Disabled: Battery will discharge only during peak hours when electricity rates are high. During other times, battery will be idle or will charge from solar in the morning to get ready for the next period
  - `charge_from_grid` string: Charge battery from grid enabled/disabled. Enabled: Battery may also charge from the grid when in full backup mode or when battery charge is below the reserve capacity in savings or self-consumption mode
  - `battery_shutdown_level` integer: Level at which battery shutdowns to conserve energy. Battery restarts by using the conserved energy when the utility grid restores power or solar panels start producing energy

## Other responses

- `401`: Authentication Error
- `403`: Forbidden
- `404`: Not Found
- `405`: Method Not Allowed
- `422`: Unprocessable Entity
- `429`: Too Many Requests
- `501`: Not Implemented

---

[API](https://skmtc.dev/enphase/apis/monitoring-api.md) - [All operations](https://skmtc.dev/enphase/apis/monitoring-api/llms.txt) - [OpenAPI document](https://skmtc.dev/enphase/apis/monitoring-api/revisions/a783ff728669?raw)