Skip to main content
POST
/
hvac
/
{deviceId}
curl
curl --request POST \
  --url 'https://api.amps.ai/hvac/dev_abc123' \
  --header 'x-api-key: amps_sk_test_xxxxxxxxxxxxxxxxxxxxxxxx' \
  --header 'content-type: application/json' \
  --data '{
    "action": "follow_schedule"
  }'
{
  "actionId": "act_20260507100hvac01",
  "state": "acknowledged",
  "type": "hvac:set_permanent_hold",
  "createdAt": "2026-05-07T10:00:00.000Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.amps.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
deviceId
string
required

The unique identifier for the HVAC device

Example:

"device_abc123"

Body

application/json

The action to perform on the HVAC device

Resume the automatic schedule on the thermostat, releasing any active hold.

​
action
string
required

Action type — resume automatic HVAC schedule.

Allowed value: "follow_schedule"
​
sandbox
object

Optional sandbox configuration for testing.

Response

Action acknowledged and queued for processing

​
actionId
string
required

Unique identifier for the action.

​
state
enum<string>
required

Current state of the action.

Available options:
acknowledged,
completed,
failed
​
type
enum<string>
required

Type of action being performed.

Available options:
hvac:follow_schedule,
hvac:set_permanent_hold
​
createdAt
string<date-time>
required

Timestamp when the action was created.