Sets a specified to .
POST /thermostats/heat ⇒ { action_attempt }
Authentication Methods
Personal access token
Must also include the seam-workspace
header in the request.
To learn more, see .
Request Parameters
device_id
String (Required)
ID of the thermostat device that you want to set to heat mode.
heating_set_point_celsius
Number
Desired in °C. You must set one of the heating_set_point
parameters.
heating_set_point_fahrenheit
Number
Desired in °F. You must set one of the heating_set_point
parameters.
Response
SET_HVAC_MODE
{
action_attempt_id: [example value],
action_type: [example value],
error: [example value],
result: [example value],
status: [example value]
}
Examples
Set to heat mode
Specify the desired heating set point in °C or °F.
Code
await seam.thermostats.heat({
device_id: "123e4567-e89b-12d3-a456-426614174000",
heating_set_point_celsius: 20,
});
Output
{
"action_attempt_id": "123e4567-e89b-12d3-a456-426614174000",
"status": "pending",
"action_type": "SET_HEAT"
}
Code
seam.thermostats.heat(
device_id="123e4567-e89b-12d3-a456-426614174000", heating_set_point_celsius=20
)
Output
ActionAttempt(
action_attempt_id="123e4567-e89b-12d3-a456-426614174000",
status="pending",
action_type="SET_HEAT",
)
Code
seam.thermostats.heat(
device_id: "123e4567-e89b-12d3-a456-426614174000",
heating_set_point_celsius: 20,
)
Output
{
"action_attempt_id" => "123e4567-e89b-12d3-a456-426614174000",
"status" => "pending",
"action_type" => "SET_HEAT",
}
Code
<?php
$seam->thermostats->heat(
device_id: "123e4567-e89b-12d3-a456-426614174000",
heating_set_point_celsius: 20
);
Output
<?php
[
"action_attempt_id" => "123e4567-e89b-12d3-a456-426614174000",
"status" => "pending",
"action_type" => "SET_HEAT",
];
Code
seam thermostats heat --device_id "123e4567-e89b-12d3-a456-426614174000" --heating_set_point_celsius 20
Output
{
"action_attempt_id": "123e4567-e89b-12d3-a456-426614174000",
"status": "pending",
"action_type": "SET_HEAT"
}
Code
package main
import api "github.com/seamapi/go"
func main() {
client.Thermostats.Heat(
context.Background(),
api.ThermostatsHeatRequest{
DeviceId: api.String("123e4567-e89b-12d3-a456-426614174000"),
HeatingSetPointCelsius: api.Float64(20),
},
)
}
Output
api.ActionAttempt{ActionAttemptId: "123e4567-e89b-12d3-a456-426614174000", Status: "pending", ActionType: "SET_HEAT"}
Code
curl --include --request POST "https://connect.getseam.com/thermostats/heat" \
--header "Authorization: Bearer $SEAM_API_KEY" \
--json @- <<EOF
{
"device_id": "123e4567-e89b-12d3-a456-426614174000",
"heating_set_point_celsius": 20
}
EOF
Output
{
"action_attempt": {
"action_attempt_id": "123e4567-e89b-12d3-a456-426614174000",
"status": "pending",
"action_type": "SET_HEAT"
}
}