{"metadata":{"image":[],"title":"","description":""},"api":{"url":"/lights/:selector/effects/flame","auth":"required","results":{"codes":[{"name":"","code":"{\n \"results\": [\n {\n \"id\": \"d3b2f2d97452\",\n \"label\": \"My tile\",\n \"status\": \"ok\"\n }\n ]\n}","language":"json","status":"2XX"}]},"settings":"","examples":{"codes":[{"code":"curl -X POST \"https://api.lifx.com/v1/lights/all/effects/flame\" \\\n -H \"Authorization: Bearer [[app:Token]]\" \\\n -H \"Content-Type:application/json\"\n -d '{\"power_on\": true}'","language":"curl","name":null},{"language":"python","code":"import requests\n\ntoken = \"[[app:Token]]\"\n\nheaders = {\n \"Authorization\": \"Bearer %s\" % token,\n}\n\ndata = {\n \"power_on\": True\n}\n\nresponse = requests.post('https://api.lifx.com/v1/lights/all/effects/flame', data=data, headers=headers)"}]},"method":"post","params":[{"name":"selector","type":"string","default":"","desc":"The [selector](doc:selectors) to limit which devices will run the effect.","required":false,"in":"path","ref":"","_id":"5c47d63469cb1d04074725d3"},{"name":"period","type":"double","default":"5","desc":"This controls how quickly the flame runs. It is measured in seconds. A lower number means the animation is faster","required":false,"in":"body","ref":"","_id":"5c47d5fd69cb1d04074725d1"},{"name":"duration","type":"float","default":"infinite","desc":"How long the animation lasts for in seconds. Not specifying a duration makes the animation never stop. Specifying 0 makes the animation stop. Note that there is a known bug where the tile remains in the animation once it has completed if duration is nonzero.","required":false,"in":"body","ref":"","_id":"5c64ffec00892c00ecc173ef"},{"name":"power_on","type":"boolean","default":"true","desc":"Switch any selected device that is off to on before performing the effect.","required":false,"in":"body","ref":"","_id":"5c47d5fd69cb1d04074725cf"},{"name":"fast","type":"boolean","default":"false","desc":"Execute the query [fast](doc:set-state#fast-mode), without initial state checks and wait for no results.","required":false,"in":"body","ref":"","_id":"5ecf0d027547af0049a1f446"}]},"next":{"description":"","pages":[]},"title":"Flame Effect","type":"endpoint","slug":"flame-effect","excerpt":"","body":"Performs a flame effect on the tiles in your selector. Use the parameters to tweak the effect. Note that the brightness of the flame is determined by the brightness of the tile. To change the brightness, use the SetState endpoint.","updates":[],"order":9,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"5c6500ecc5d11a005d81e9e7","project":"54ebb40d6423300d003672c0","version":{"version":"1","version_clean":"1.0.0","codename":"","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["55f28172f9f3991900f38a14","55f28172f9f3991900f38a15","55f28172f9f3991900f38a16","55f66acb297b37170058accb","5d229ff5e59b8e003ab3a9da"],"_id":"55f28172f9f3991900f38a13","project":"54ebb40d6423300d003672c0","releaseDate":"2015-09-11T07:23:30.065Z","createdAt":"2015-09-11T07:23:30.065Z","__v":3},"category":{"sync":{"isSync":false,"url":""},"pages":["55f28173f9f3991900f38a1d","55f28173f9f3991900f38a1e","55f28173f9f3991900f38a1f","55f28173f9f3991900f38a20","55f28173f9f3991900f38a21","55f28173f9f3991900f38a22","55f28173f9f3991900f38a23","55f28173f9f3991900f38a24","55f28173f9f3991900f38a25","55f28173f9f3991900f38a26","55f28173f9f3991900f38a27","55f63d46fe4cce21005c785e","55f65cc16be5ea0d00bbbf4c"],"title":"API Endpoints","slug":"api-endpoints","order":2,"from_sync":false,"reference":false,"_id":"55f28172f9f3991900f38a16","__v":3,"createdAt":"2015-06-17T05:23:31.147Z","project":"54ebb40d6423300d003672c0","version":"55f28172f9f3991900f38a13"},"user":"57749b725b96cf0e00558ea6","createdAt":"2019-02-14T05:47:24.238Z","__v":5,"parentDoc":null}
postFlame Effect
Definition
{{ api_url }}{{ page_api_url }}
Parameters
Path Params
selector:
string
The [selector](doc:selectors) to limit which devices will run the effect.
Body Params
period:
double5
This controls how quickly the flame runs. It is measured in seconds. A lower number means the animation is faster
duration:
floatinfinite
How long the animation lasts for in seconds. Not specifying a duration makes the animation never stop. Specifying 0 makes the animation stop. Note that there is a known bug where the tile remains in the animation once it has completed if duration is nonzero.
power_on:
booleantrue
Switch any selected device that is off to on before performing the effect.
fast:
booleanfalse
Execute the query [fast](doc:set-state#fast-mode), without initial state checks and wait for no results.