Device Operations

​

What are Device Operations?

Device Operations are the core actions you can perform with connected devices through the Amps AI API. There are three main types: Pull (retrieve data), Push (send commands), and Action Polling (check command status).

​

Pull Operations

Pull operations retrieve the current state and status of a device. Use pull operations to:

• Monitor battery charge levels and capacity
• Check HVAC temperature settings and mode
• View solar inverter production data
• Track EV charging status and battery level
• Get real-time device status

All pull operations return consistent data structures, making it easy to work with devices from different OEMs.

​

Push Operations

Push operations send commands to control devices. Use push operations to:

• Set HVAC temperature and mode
• Start or stop EV charging sessions
• Control battery charging/discharging
• Adjust device settings

Commands are processed asynchronously—the API immediately returns an action ID, and you can track completion via webhooks or polling.

​

Action Polling

When you send a push command, it returns an action ID immediately. Use action polling to:

• Check if a command is still processing
• Verify command completion status
• Handle errors and retries

Actions transition through states: acknowledged → completed or failed. You can poll the action status endpoint or receive webhook notifications when actions complete.

​

Use Cases

​

Smart Home Automation

Pull HVAC temperature and battery state, then push commands to optimize energy usage. For example, pre-cool a home using battery power during peak solar production, then use HVAC to maintain comfort.

​

Fleet Charging Management

Pull EV battery levels across a fleet, then push commands to start charging sessions during off-peak hours or when solar production is high.

​

Demand Response

Pull device states to assess available load reduction capacity, then push commands to reduce HVAC usage or pause EV charging during peak demand periods.

​

Next Steps