Skip to main content

HTTP API

The stock firmware enables ESPHome's Web Server component, which in turn enables an HTTP API (on port 80). Since the stock firmware exposes a sensor for reporting the current desk height, and a number to set the target height, you can use these simple HTTP endpoints to write your integrations.

See ESPHome's documentation on the sensor and number endpoints for more information about what responses you will receive.

Get Actual Desk Height

See Sensor

GET /sensor/desk_height

Get Target Desk Height

See Number

GET /number/target_desk_height

Set Target Desk Height

See Number

POST /number/target_desk_height/set?value=the_value_to_set

Set Desk Preset

See Button

Replace {n} with a preset number 1-4.

POST /button/desk_preset_{n}/press