Skip to main content

​
Heat Pump Attributes

Heat pump attributes are writable parameters that control device behavior and optimization settings.

​
Required Parameters

​
user_id
string (UUID)
required
User ID that owns this heat pump device.Example: 016b78a7-0c7c-4241-a277-015c3ad3cb90Writable: No (set at device creation)

​
Device Model

​
device_model
object
The device model assigned to this heat pump. Set during onboarding.Writable: No (set at device creation)

​
Optimization Control

​
is_smart_optimization_active
boolean
Flag indicating whether Podero’s smart optimization is actively controlling this device.Set to false to pause optimization without disconnecting the device.Example: trueWritable: Yes
​
optimization_level
enum
The aggressiveness ceiling at which Podero optimizes this heat pump. Controls how far the system will shift the heat pump’s operation to chase cheap spot price windows.Options: Low, Mid, MaxExample: MidWritable: Yes

​
Usage Examples

​
Enable Optimization

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
  }'

​
Best Practices

  • Keep is_smart_optimization_active enabled for cost savings
  • Optimization works best with spot hourly energy pricing

Heat Pump State

Read-only state data and current readings

Setting Preferences

User workflow for configuring preferences

Device Onboarding

Connecting heat pump devices