{"_id":"5ab16b00a675fe0012f69c0b","project":"568bdc1483d2061900d86cdc","version":{"_id":"59a72290d61777001b6c42c3","project":"568bdc1483d2061900d86cdc","__v":31,"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","5b258091bc7a6700033b9cb5","5b26e48e024807000315a740","5b44edff3306680003663f5c","5b468abd3d4a9e0003789111","5b468d8f3dcb6a0003c6e374","5b47b0b93d4a9e000378a33a","5b538d114ea24f00033c726f","5b6a0efe402b32000336c33f"],"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":19,"slug":"devices-api","title":"Devices API"},"user":"5a6a26281895510045b2cd40","githubsync":"","__v":14,"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2018-03-20T20:11:44.388Z","link_external":false,"link_url":"","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{\n\t\"properties\": {\n  \t\"BinarySwitch.switch\": \"on\",\n    \"LightColor.brightness\": 100\n  }\n}\n","language":"http"},{"code":"droplit.devices.setMulticommand(\"D5b22163ce40f84d8e41f2fa7\", [ { \"name\" : \"BinarySwitch.switch\", \"value\" : \"on\" }, { \"name\" : \"LightColor.brightness\", \"value\" : 100 } ]);","language":"javascript","name":"Droplit SDK"}]},"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":9,"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

Examples


Result Format


Documentation

Alter the service properties of a device. An account token, server token, or user token may be used to run this endpoint. If 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.

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