Control Fan

Set fan mode or start a fan timer

Overview

Control the thermostat’s fan independently of heating/cooling. Set the fan to always on, auto (runs with HVAC), or start a timed fan run.

Hosted service only. This endpoint is part of the hosted API at https://nolongerevil.com/api/v1 and requires an nle_ API key. It is not available on the self-hosted server.

Endpoint

POST https://nolongerevil.com/api/v1/thermostat/{deviceId}/fan

Authentication

Required Scopes: write

Request Body

For fan mode:

Field	Type	Required	Description
mode	string	Yes	"on", "auto", or "off"

For fan timer:

Field	Type	Required	Description
duration	number	Yes	Duration in seconds (max 43200 = 12 hours)

Example: Set Fan Mode

{
  "mode": "on"
}

Example: Start Fan Timer

{
  "duration": 900
}

Response

Success (200 OK):

{
  "success": true,
  "message": "Command handled",
  "device": "02AA01AB01234567",
  "object": "device.02AA01AB01234567",
  "revision": 90,
  "timestamp": 1764026410000
}

Fan Modes

Mode	Description
on	Fan runs continuously
auto	Fan runs only when heating/cooling is active
off	Fan off (system idle)

Fan timers automatically set the fan to auto mode after the duration expires.

Code Examples

cURL - Set Mode

curl -X POST https://nolongerevil.com/api/v1/thermostat/dev_abc123xyz/fan \
  -H "Authorization: Bearer nle_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"mode": "on"}'

Use Cases

Air Circulation

// Run fan for 15 minutes every hour to circulate air
setInterval(async () => {
  await startFanTimer(deviceId, 15 * 60); // 15 minutes
}, 60 * 60 * 1000); // Every hour

Post-Cooking Ventilation

// Run fan after cooking to remove odors
await startFanTimer(deviceId, 30 * 60); // 30 minutes

Next Steps

Get Status

Check fan status

Set Temperature

Control temperature