Scenes & schedules

Save a scene

POST/api/scenes

Guest area “scenes”. Open unless a PIN lock is set and guests aren't allowed this area (settings.guest.scenes); then it needs an unlock token.

{name} saves the current look as a scene; or give its show and brightness.

Request body application/json

namestring

Up to 60 characters

showobject

The show fields to set; left out: the current show.

brightnessnumber

Responses

200OKapplication/json

idstringrequired

namestringrequired

showobject

The show fields this scene sets (see Show).

brightnessnumber

0 to 1

403Locked, or not allowed.application/json

errorstringrequired

What went wrong, in a sentence for people.

Request

curl -X POST 'http://localhost:8080/api/scenes' \
  -H 'content-type: application/json' \
  -d '{
  "name": "Movie night"
}'

const res = await fetch("http://localhost:8080/api/scenes", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({
    "name": "Movie night"
  }),
});
const data = await res.json();
console.log(data);

import requests

res = requests.post(
    "http://localhost:8080/api/scenes",
    json={
        "name": "Movie night"
    },
)
print(res.json())

Response

{
  "id": "party",
  "name": "Party mode",
  "show": {
    "mode": "auto",
    "style": "party",
    "palette": "auto"
  },
  "brightness": 1
}

{
  "error": "Settings are locked. Unlock with the PIN in Settings."
}