Music
Reset a song's show
DEL
/api/songs/{id}/showGuest area “effects”. Open unless a PIN lock is set and guests aren't allowed this area (
settings.guest.effects); then it needs an unlock token.Throws away your edits (colours, cues and brightness too) and makes a new show.
Path parameters
idstringrequiredA song id (m…).
Responses
200OKapplication/json
oktruerequiredidstringnamestringdurnumbereditedbooleanshowobject[]colorsobject[]cuesobject[]brightobject[]403Locked, or not allowed.application/json
errorstringrequiredWhat went wrong, in a sentence for people.
404No such id.application/json
errorstringrequiredWhat went wrong, in a sentence for people.
Request
curl -X DELETE 'http://localhost:8080/api/songs/m9x2q1/show'const res = await fetch("http://localhost:8080/api/songs/m9x2q1/show", {
method: "DELETE",
});
const data = await res.json();
console.log(data);import requests
res = requests.delete(
"http://localhost:8080/api/songs/m9x2q1/show",
)
print(res.json())Response
{
"ok": true,
"id": "m9x2q1",
"name": "One More Time",
"dur": 320.4,
"edited": false,
"show": [
{
"t0": 0,
"t1": 32,
"part": "calm",
"effect": "aurora"
}
],
"colors": [],
"cues": [],
"bright": []
}{
"error": "Settings are locked. Unlock with the PIN in Settings."
}{
"error": "That song isn't remembered"
}