Skip to main content

Change a configuration parameter on a charger

POST 
/chargers/:id/actions/change-configuration

Sends an OCPP ChangeConfiguration command to modify a charger's configuration key-value pair.

Use Cases:

  • Adjust heartbeat intervals for connectivity monitoring
  • Configure meter value sampling frequency
  • Set maximum charging current limits
  • Modify WebSocket reconnect behavior
  • Update authorization cache settings

Common Configuration Keys:

  • HeartbeatInterval: Seconds between heartbeat messages
  • MeterValueSampleInterval: Seconds between meter value samples
  • WebSocketPingInterval: WebSocket keep-alive frequency
  • MaxChargingProfilesInstalled: Profile capacity limit
  • LocalAuthorizeOffline: Allow offline authorization

Important Notes:

  • Configuration keys are vendor-specific, consult charger documentation
  • Some keys require charger reboot to take effect
  • Invalid keys return rejection status in response
  • Changes persist across reboots
  • Read-only keys cannot be modified
warning

Only send supported OCPP keys as defined by the charger manufacturer. Invalid keys will be rejected. Some keys require a reboot to take effect.

tip

Use GetConfiguration first to discover supported keys and current values before attempting changes.

Request​

Responses​

Standard success response for actions