Set to Heat Mode

• Request Parameters

• Response

Sets a specified thermostat to heat mode.

JavaScript

Sets a specified thermostat to heat mode.

Code:

await seam.thermostats.heat({
  device_id: "e4b111b8-e2bd-4f49-a9c8-96ed5390e1d5",
  heating_set_point_fahrenheit: 65,
});

Output:

{
  "action_attempt_id": "b0e1d2c3-4f5e-6a7b-8c9d-0e1f2a3b4c5d",
  "action_type": "SET_HVAC_MODE",
  "error": null,
  "result": {},
  "status": "success"
}

cURL

Sets a specified thermostat to heat mode.

Code:

curl --include --request POST "https://connect.getseam.com/thermostats/heat" \
  --header "Authorization: Bearer $SEAM_API_KEY" \
  --json @- <<EOF
{
  "device_id": "e4b111b8-e2bd-4f49-a9c8-96ed5390e1d5",
  "heating_set_point_fahrenheit": 65
}
EOF

Output:

{
  "action_attempt": {
    "action_attempt_id": "b0e1d2c3-4f5e-6a7b-8c9d-0e1f2a3b4c5d",
    "action_type": "SET_HVAC_MODE",
    "error": null,
    "result": {},
    "status": "success"
  }
}

Python

Sets a specified thermostat to heat mode.

Code:

seam.thermostats.heat(
    device_id="e4b111b8-e2bd-4f49-a9c8-96ed5390e1d5", heating_set_point_fahrenheit=65
)

Output:

ActionAttempt(
    action_attempt_id="b0e1d2c3-4f5e-6a7b-8c9d-0e1f2a3b4c5d",
    action_type="SET_HVAC_MODE",
    error=None,
    result={},
    status="success",
)

Ruby

Sets a specified thermostat to heat mode.

Code:

seam.thermostats.heat(
  device_id: "e4b111b8-e2bd-4f49-a9c8-96ed5390e1d5",
  heating_set_point_fahrenheit: 65,
)

Output:

{
  "action_attempt_id" => "b0e1d2c3-4f5e-6a7b-8c9d-0e1f2a3b4c5d",
  "action_type" => "SET_HVAC_MODE",
  "error" => nil,
  "result" => {
  },
  "status" => "success",
}

PHP

Sets a specified thermostat to heat mode.

Code:

$seam->thermostats->heat(
    device_id: "e4b111b8-e2bd-4f49-a9c8-96ed5390e1d5",
    heating_set_point_fahrenheit: 65
);

Output:

[
    "action_attempt_id" => "b0e1d2c3-4f5e-6a7b-8c9d-0e1f2a3b4c5d",
    "action_type" => "SET_HVAC_MODE",
    "error" => null,
    "result" => [],
    "status" => "success",
];

Seam CLI

Sets a specified thermostat to heat mode.

Code:

seam thermostats heat --device_id "e4b111b8-e2bd-4f49-a9c8-96ed5390e1d5" --heating_set_point_fahrenheit 65

Output:

{
  "action_attempt_id": "b0e1d2c3-4f5e-6a7b-8c9d-0e1f2a3b4c5d",
  "action_type": "SET_HVAC_MODE",
  "error": null,
  "result": {},
  "status": "success"
}

Authentication Methods

• API key

• Client session token

• Personal access token Must also include the seam-workspace header in the request.

To learn more, see Authentication.

Request Parameters

device_id String (Required)

ID of the thermostat device that you want to set to heat mode.

---

heating_set_point_celsius Number

Heating set point in °C that you want to set for the thermostat. You must set one of the heating_set_point parameters.

---

heating_set_point_fahrenheit Number

Heating set point in °F that you want to set for the thermostat. You must set one of the heating_set_point parameters.

---

Response

action_attempt

JSON

{
  "action_attempt_id": "b0e1d2c3-4f5e-6a7b-8c9d-0e1f2a3b4c5d",
  "action_type": "SET_HVAC_MODE",
  "error": null,
  "result": {},
  "status": "success"
}