Overview
Configure the temperature range for heat-cool (auto) mode. The thermostat will heat when below the low threshold and cool when above the high threshold.
Endpoint
POST https://nolongerevil.com/api/v1/thermostat/{deviceId}/temperature/range
Authentication
Required Scopes: write
Request Body
| Field | Type | Required | Description |
|---|
low | number | Yes | Minimum temperature (heating threshold) |
high | number | Yes | Maximum temperature (cooling threshold) |
scale | string | No | "C" (default) or "F" |
{
"low": 68,
"high": 74,
"scale": "F"
}
low must be less than high. Most thermostats require at least 2-3°F (1-2°C) difference.
Response
Success (200 OK):
{
"success": true,
"message": "Command handled",
"device": "02AA01AB01234567",
"object": "shared.02AA01AB01234567",
"revision": 154,
"timestamp": 1764026400108
}
Code Examples
curl -X POST https://nolongerevil.com/api/v1/thermostat/dev_abc123xyz/temperature/range \
-H "Authorization: Bearer nle_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{"low": 68, "high": 74, "scale": "F"}'
Use Cases
Comfort Range
// Maintain 68-74°F for optimal comfort
await setTemperatureRange(deviceId, 68, 74, 'F');
Energy Efficiency
// Wider range = less HVAC cycling = energy savings
await setTemperatureRange(deviceId, 65, 78, 'F');
Next Steps