Home & sleep
Start a sunrise
POST
/api/wakeBrightness or link key. Like the
brightness guest area, or with the wake-up link key (x-tempolight-key header, ?key= or key in the body), which opens the wake and sleep calls only.Full light at that time (within 36 hours); with no time, the sunrise starts now. 409 when wake-up is off. Answers the home status (also status.home).
Request body application/json optional
inMinutesnumberatstring | numberdurationintegerMinutes, 1 to 120.
1 to 120keystringThe link key.
Responses
200OKapplication/json
wakeobject | nullnextWakestring | null <date-time>An ISO date and time.
sleepobject | nullplanobject | null400The body isn't valid JSON, or a value is wrong.application/json
errorstringrequiredWhat went wrong, in a sentence for people.
403Locked, or not allowed.application/json
errorstringrequiredWhat went wrong, in a sentence for people.
409Can't do that now.application/json
errorstringrequiredWhat went wrong, in a sentence for people.
Request
curl -X POST 'http://localhost:8080/api/wake' \
-H 'content-type: application/json' \
-d '{
"at": "07:00",
"duration": 20
}'const res = await fetch("http://localhost:8080/api/wake", {
method: "POST",
headers: { "content-type": "application/json" },
body: JSON.stringify({
"at": "07:00",
"duration": 20
}),
});
const data = await res.json();
console.log(data);import requests
res = requests.post(
"http://localhost:8080/api/wake",
json={
"at": "07:00",
"duration": 20
},
)
print(res.json())Response
{
"wake": null,
"nextWake": "2026-11-05T06:30:00.000Z",
"sleep": null,
"plan": null
}{
"error": "at is a time like 07:00, an ISO date or milliseconds, within 36 hours"
}{
"error": "Locked: add ?key=<your wake-up link key> (Home & sleep page) or unlock with the PIN"
}{
"error": "Wake-up is turned off (Home & sleep page)"
}