{"_id":"582789acbe5c080f00a5a853","version":{"_id":"582789aabe5c080f00a5a7fe","__v":10,"project":"568bdc1483d2061900d86cdc","createdAt":"2016-11-12T21:29:14.915Z","releaseDate":"2016-11-12T21:29:14.915Z","categories":["582789abbe5c080f00a5a7ff","582789abbe5c080f00a5a800","582789abbe5c080f00a5a801","582789abbe5c080f00a5a802","582789abbe5c080f00a5a803","582789abbe5c080f00a5a804","582789abbe5c080f00a5a805","582789abbe5c080f00a5a806","582789abbe5c080f00a5a807","582789abbe5c080f00a5a808","5827ea984ca29e0f00137a9e","583df597887db62f00644283","583df5d9c622791900e78da5","5845cd8763c11b250037967d","5845d13063c11b2500379681","5859e859e3306d1900126725","587aeb9a01cf3a0f008359eb","587c422af45e2d0f005e200d","587d84dc82f6f30f004ceee5"],"is_deprecated":false,"is_hidden":false,"is_beta":true,"is_stable":true,"codename":"beta2","version_clean":"0.0.0","version":"0"},"parentDoc":null,"user":"568bdbc4fe6fcc0d006dc970","category":{"_id":"582789abbe5c080f00a5a803","__v":0,"version":"582789aabe5c080f00a5a7fe","project":"568bdc1483d2061900d86cdc","sync":{"url":"","isSync":false},"reference":true,"createdAt":"2016-01-05T15:14:04.838Z","from_sync":false,"order":9,"slug":"something","title":"Devices"},"project":"568bdc1483d2061900d86cdc","__v":0,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-05-20T08:37:44.048Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"examples":{"codes":[{"code":"PUT https://ioe.droplit.io/api/devices/D573bc694ae9ac9419f028b61/services/BinarySwitch.switch HTTP/1.1\nauthorization: AUTH_TOKEN\ncontent-type: application/json\n\n{\n    \"value\": \"on\"\n}","language":"http"},{"code":"droplit device set D573bc694ae9ac9419f028b61 BinarySwitch.switch on","language":"text","name":"droplit console"}]},"method":"put","results":{"codes":[{"language":"json","code":" ","name":"","status":200},{"status":400,"language":"json","code":"{\n  \"errorType\": \"InvalidBody\",\n  \"errors\": [\n    {\n      \"message\": \"value was undefined\"\n    }\n  ]\n}","name":""},{"code":"","language":"text","status":401},{"code":"","language":"text","status":403},{"code":"Device with id D573bc694ae9ac9419f028b62 does not exist.","language":"text","status":404}]},"settings":"572c39957c8eff0e00aaa18b","auth":"required","params":[{"_id":"573ecd82804f901700a9dfbf","ref":"","in":"path","required":true,"desc":"[device](doc:devices) id or [alias](doc:aliases)","default":"","type":"string","name":"id"},{"_id":"573ecd82804f901700a9dfbe","ref":"","in":"path","required":true,"desc":"[property selector](doc:service-selectors)","default":"","type":"string","name":"selector"},{"_id":"573ece09a233380e005db12c","ref":"","in":"body","required":true,"desc":"Value to set","default":"","type":"object","name":"value"}],"url":"/devices/:id/services/:selector"},"isReference":true,"order":9,"body":"You can set any property with this endpoint.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Parameter notes\"\n}\n[/block]\n## value\nIf setting a custom property that does not currently exist, it will be created if the device is a virtual device.","excerpt":"Set a service property","slug":"set-device-property","type":"endpoint","title":"Set Property"}

putSet Property

Set a service property

Definition

{{ api_url }}{{ page_api_url }}

Parameters

Path Params

id:
required
string
[device](doc:devices) id or [alias](doc:aliases)
selector:
required
string
[property selector](doc:service-selectors)

Body Params

value:
required
object
Value to set

Examples


Result Format


Documentation

You can set any property with this endpoint. [block:api-header] { "type": "basic", "title": "Parameter notes" } [/block] ## value If setting a custom property that does not currently exist, it will be created if the device is a virtual device.

User Information

Try It Out

put
{{ tryResults.results }}
Method{{ tryResults.method }}
Request Headers
{{ tryResults.requestHeaders }}
URL{{ tryResults.url }}
Request Data
{{ tryResults.data }}
Status
Response Headers
{{ tryResults.responseHeaders }}