POST Assign Hierarchy Thermostat

URL: /hierarchy/thermostat

Accessible by: EMS, Utility accounts only.

Restrictions: User must have the hierarchy privilege on the source and destination sets.

Forcefully moves one or more thermostats from their current set to the specified set. At the end of the successful operation the thermostat(s) will be in the specified set.

See Getting Started with Management Set Hierarchy for additional information.

Request Properties

Property Version Type Required Description
operation 1 String Yes The type of request. Always "assign".
setPath 1 String Yes The set path the thermostats are being moved to.
thermostats 1 String Yes Comma separated list of thermostat identifiers.

Response Properties

Property Version Type Description
status 1 Status The api response code.

Example Request:

Request Body

NOTE: Request body is not encoded for example purposes.

HEADERS:
	Content-Type: application/json;charset=UTF-8
	Authorization: Bearer Rc7JE8P7XUgSCPogLOx2VLMfITqQQrjg
	
REQUEST:
	POST https://api.ecobee.com/1/hierarchy/thermostat?format=json
	
POST BODY:
{
	"operation": "assign",
	"setPath": "/MainNode",
	"thermostats": "123456789012,123456789013"
}
				

Sample API Call

Show code sample in:
curl -s --request POST --data-urlencode @json.txt -H "Content-Type: application/json;charset=UTF-8" -H "Authorization: Bearer ACCESS_TOKEN" "https://api.ecobee.com/1/hierarchy/thermostat?format=json"  
				

Example Response:

{
    "status": {
        "code": 0,
        "message": ""
    }
}
    

Back To Top