Skip to main content

​
Setting Device Preferences

End-users want to stay in control of their devices while benefiting from smart optimization. This page covers the most common preference scenarios for each device type and how to implement them. All preferences are updated via the device’s PUT endpoint. Only send the fields you want to change — other fields remain unaffected.

​
Heat Pump

​
Pause optimization while away

If a user is going on vacation or doesn’t want Podero to control their heat pump for a period, disable optimization. The device falls back to its own built-in schedule until optimization is re-enabled. 
curl -X PUT \
  'https://app.podero.com/api/partners/v2.0/org/{org_id}/users/{user_id}/heat-pumps/{device_id}' \
  -H 'Authorization: Bearer {auth_token}' \
  -H 'Content-Type: application/json' \
  -d '{
    "is_smart_optimization_active": false
  }'

​
Resume optimization

When the user returns, re-enable optimization with the same endpoint: 
curl -X PUT \
  'https://app.podero.com/api/partners/v2.0/org/{org_id}/users/{user_id}/heat-pumps/{device_id}' \
  -H 'Authorization: Bearer {auth_token}' \
  -H 'Content-Type: application/json' \
  -d '{
    "is_smart_optimization_active": true
  }'

Heat Pump Attributes Reference

Full list of writable heat pump fields

​
Electric Vehicle

​
Charge now

If the user needs to start charging immediately — for example, they forgot to plug in the night before and need to leave soon — trigger a boost charge. Depending on vehicle state, the boost either starts charging right away or arms itself for when the vehicle next connects. 
curl -X POST \
  'https://app.podero.com/api/partners/v2.0/org/{org_id}/users/{user_id}/electric-vehicles/{device_id}/boost' \
  -H 'Authorization: Bearer {auth_token}'
Vehicle stateResult
Plugged in, idleStarts charging immediately, bypassing optimization
UnpluggedArms boost — charging starts automatically when the vehicle next connects
Already charging or fully chargedReturns 409 — no action needed
To cancel an armed boost before the vehicle connects: 
curl -X DELETE \
  'https://app.podero.com/api/partners/v2.0/org/{org_id}/users/{user_id}/electric-vehicles/{device_id}/boost' \
  -H 'Authorization: Bearer {auth_token}'

​
Set a charge deadline

For users with a regular commute, a charge policy ensures the vehicle reaches a minimum charge level by a set time. Podero will still optimize for cheap overnight hours, but will always meet the deadline. Enable the policy and set a default target that applies every day: 
curl -X PUT \
  'https://app.podero.com/api/partners/v2.0/org/{org_id}/users/{user_id}/electric-vehicles/{device_id}' \
  -H 'Authorization: Bearer {auth_token}' \
  -H 'Content-Type: application/json' \
  -d '{
    "is_charge_policy_enabled": true,
    "charge_deadline_at": "07:00",
    "minimum_charge_limit": 80
  }'

​
Set a weekly schedule

When is_charge_policy_enabled is true, users can configure a different target and deadline for each day of the week via the /charge-policy endpoint — useful for users whose schedule varies between weekdays and weekends: 
curl -X PUT \
  'https://app.podero.com/api/partners/v2.0/org/{org_id}/users/{user_id}/electric-vehicles/{device_id}/charge-policy' \
  -H 'Authorization: Bearer {auth_token}' \
  -H 'Content-Type: application/json' \
  -d '{
    "timezone": "Europe/Berlin",
    "mon": { "charge_percentage": 80, "charge_deadline": "07:00" },
    "tue": { "charge_percentage": 80, "charge_deadline": "07:00" },
    "wed": { "charge_percentage": 80, "charge_deadline": "07:00" },
    "thu": { "charge_percentage": 80, "charge_deadline": "07:00" },
    "fri": { "charge_percentage": 80, "charge_deadline": "07:00" },
    "sat": { "charge_percentage": 50, "charge_deadline": "10:00" },
    "sun": { "charge_percentage": 50, "charge_deadline": "10:00" }
  }'
To disable the charge policy entirely and return to fully cost-optimized charging: 
{ "is_charge_policy_enabled": false }

Electric Vehicle Attributes Reference

Full list of writable EV fields, including charge policy details

​
Solar Inverter

​
Pause optimization

If a user wants to stop Podero from controlling their inverter temporarily, disable optimization. The inverter falls back to its own default behavior until optimization is re-enabled. 
curl -X PUT \
  'https://app.podero.com/api/partners/v2.0/org/{org_id}/users/{user_id}/inverters/{device_id}' \
  -H 'Authorization: Bearer {auth_token}' \
  -H 'Content-Type: application/json' \
  -d '{
    "is_smart_optimization_active": false
  }'

​
Resume optimization

curl -X PUT \
  'https://app.podero.com/api/partners/v2.0/org/{org_id}/users/{user_id}/inverters/{device_id}' \
  -H 'Authorization: Bearer {auth_token}' \
  -H 'Content-Type: application/json' \
  -d '{
    "is_smart_optimization_active": true
  }'

Solar Inverter Attributes Reference

Full list of writable inverter fields

​
Next Steps

Dashboard Integration

Display device status and consumption data

Device Onboarding

Connect and set up new devices