{"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}