Skip to main content

Overview

Updates a Nest thermostat’s cloudregisterurl setting to point at this NLE server. After this call, the device will connect to this server on its next boot or reconnect. This is the second step in the device setup flow, after using /api/scan-network to discover devices.

Endpoint

Request

First Attempt (no API key)

Retry With API Key (if first attempt returns 401)

Response

Success (200 OK)

Authentication Required (401)

Retry the request with "api_key": "{device_serial}" to authenticate.

Error (4xx/5xx)

What It Sets

The server sends a POST to the device’s local API (http://{ip}:8080/cgi-bin/api/settings) with:
This updates the device’s cloudregisterurl, which is the URL it uses for all cloud communication.

Examples

POST /api/scan-network

Discover devices on the network first

POST /api/register

Register a device after pointing it here