Skip to main content

Actuate Commands

info

An Execution Timeout is enforced for every request sent to a SmartApp from the SmartThings Cloud. If the SmartApp does not respond within 10 seconds, a TargetTimeoutError will be thrown and any later responses from the SmartApp ignored for that request.

Your SmartApp can execute commands on behalf of the user. A command is first sent to the SmartThings Cloud, which then calls the SmartApp Connector.

Actuate cloud device

Here is an example of a POST request body to execute a command on a device.

[
{
"component": "main",
"capability": "colorControl",
"command": "setHue",
"arguments": [
{
"value": 25,
"unit": "percent"
}
]
}
]
important

Commands are asynchronous. When a command to a device is issued by the SmartApp Connector, the 204 No content (success) response is sent back from SmartThings Cloud, only indicating that the command is valid, and that the SmartApp Connector has permissions to issue this command. Proper events will be created by SmartThings Cloud when the device is eventually actuated.