{"_id":"5ab16b00a675fe0012f69c0b","project":"568bdc1483d2061900d86cdc","version":{"_id":"59a72290d61777001b6c42c3","project":"568bdc1483d2061900d86cdc","__v":23,"createdAt":"2017-08-30T20:39:44.453Z","releaseDate":"2017-08-30T20:39:44.453Z","categories":["59a7236e3fe4d90025117c10","59a72eb6cb0db3001b84cfe2","59a734eb757d030019b85af8","59c0243b1b2d07001a9d2b76","59c035e42126e10028effb12","59c06c40df5b3c0010584a13","59c1a5852cabe5002641a3e7","59c2fb00b2b45c0010b7a3d7","59c32ceb9aea850010ac4130","59c32e6e190c90003cb0d12f","59c33affb2b45c0010b7aa23","59c7dfa457bd8200105444dc","59c7e975c50cf30010d712a0","59cffdef0cd4dd0010294d54","59d0622ca91a810032c8f60c","59d06733c1aec60026253065","59d174d44ac471001a07b123","59d5a5e323e6e800103defb2","59ecf1d8ed507c001c52b255","59f76fef8581dc0010593e6f","5a0c003680a35b0012c35db0","5a8358722e78660075e45f42","5a846645b5ec3a001203517e"],"is_deprecated":false,"is_hidden":false,"is_beta":true,"is_stable":true,"codename":"","version_clean":"0.0.0","version":"0"},"category":{"_id":"59c06c40df5b3c0010584a13","project":"568bdc1483d2061900d86cdc","version":"59a72290d61777001b6c42c3","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2017-09-19T01:00:48.384Z","from_sync":false,"order":11,"slug":"devices-api","title":"Devices API"},"user":"5a6a26281895510045b2cd40","__v":10,"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2018-03-20T20:11:44.388Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"settings":"59a750fbd61777001b6c47ed","results":{"codes":[{"name":"","code":"{\n \"transactionId\": \"5ab25968ee5af6bc2329c396\",\n \"items\": [\n {\n \"serviceMember\": \"BinarySwitch[0].switch\",\n \"status\": \"Accepted\"\n },\n {\n \t\t\"serviceMember\": \"LightColor[0].brightness\",\n \t\"status\": \"Accepted\"\n }\n ]\n}","language":"json","status":200},{"name":"Device Invalid","code":"{\n \"errorType\": \"InvalidParams\",\n \"errors\": [\n {\n \"in\": \"path\",\n \"message\": \"invalid id\",\n \"path\": \"id\"\n }\n ]\n}","language":"json","status":400},{"code":"{\n \"errorType\": \"InvalidParams\",\n \"errors\": [\n {\n \"in\": \"body\",\n \"message\": \"field is required\",\n \"path\": \"properties\"\n }\n ]\n}","language":"json","name":"Body Parameters Missing","status":400},{"code":"Device with id D5a82ed3414478c280c13af21 does not exist.","language":"text","name":"Device Not Found","status":404}]},"examples":{"codes":[{"code":"PUT https://ioe.droplit.io/api/devices/D5b22163ce40f84d8e41f2fa7/services?verify=true HTTP/1.1\nauthorization: AUTH_TOKEN\ncontent-type: application/json\n{\n\t\"properties\": {\n \t\"BinarySwitch.switch\": \"on\",\n \"LightColor.brightness\": 100\n }\n}\n","language":"http"}]},"method":"put","auth":"required","params":[{"_id":"59c17f19bc639a0032f7753e","ref":"","in":"path","required":true,"desc":"The ID of the device","default":"","type":"string","name":"id"},{"_id":"59c17f19bc639a0032f7753d","ref":"","in":"query","required":false,"desc":"When set to true, return the status of each property","default":"False","type":"boolean","name":"verify"},{"_id":"59c17f19bc639a0032f7753c","ref":"","in":"body","required":true,"desc":"List of service properties and their desired values","default":"","type":"object","name":"properties"},{"_id":"5ab174eb5ea56a0012dcfc29","ref":"","in":"header","required":true,"desc":"The user's authentication token","default":"","type":"string","name":"authorization"},{"_id":"5ab174eb5ea56a0012dcfc28","ref":"","in":"header","required":true,"desc":"Specify that the sent data will be a JSON object","default":"","type":"string","name":"content-type"}],"url":"/:id/services"},"isReference":false,"order":12,"body":"Alter the service properties of a device.\n\nAn account token, server token, or user token may be used to run this endpoint.\n\nIf there are any webhooks in the ecosystem listening for \"Set\" service notifications, their response, an example of which may be seen on the [Webhooks v2](doc:webhooks-v2) page, will include both the user's account type and ID.","excerpt":"","slug":"devices-services-alter","type":"endpoint","title":"Update Multiple Service Properties"}putUpdate Multiple Service Properties
Definition
{{ api_url }}{{ page_api_url }}
Parameters
Path Params
id:
required
string
The ID of the device
Query Params
verify:
booleanFalse
When set to true, return the status of each property
Body Params
properties:
required
object
List of service properties and their desired values
Headers
authorization:
required
string
The user's authentication token
content-type:
required
string
Specify that the sent data will be a JSON object