Clear this HVAC device's schedule - Amps AI Documentation

DELETE

hvac

{deviceId}

schedule

curl

curl --request DELETE \
  --url 'https://api.amps.ai/hvac/device_abc123/schedule' \
  --header 'x-api-key: amps_sk_test_xxxxxxxxxxxxxxxxxxxxxxxx'

{
  "success": false,
  "error": {
    "code": "DEVICE_NOT_FOUND",
    "message": "Device not found or access denied"
  },
  "meta": {
    "requestId": "req_5pH1cQbY",
    "timestamp": "2026-04-29T12:00:00.000Z",
    "path": "/hvac/device_unknown_999",
    "latencyMs": 5
  }
}

Authorizations

x-api-key

string

header

required

Path Parameters

deviceId

string

required

The unique identifier for the HVAC device.

Example:

"device_abc123"

Response

Device not found or access denied.

Uniform error response. The error.code identifies the failure, error.message carries a human-readable explanation, and error.details carries structured context (failed fields, conflicting action IDs, supported capabilities) where relevant.

success

boolean

required

Always false for error responses.

error

object

required

Error envelope.

Show child attributes

meta

object

required

Request metadata.

Show child attributes

List EV Charger devicesGet a paginated list of EV Charger devices with their last pull state

curl

curl --request DELETE \
  --url 'https://api.amps.ai/hvac/device_abc123/schedule' \
  --header 'x-api-key: amps_sk_test_xxxxxxxxxxxxxxxxxxxxxxxx'

{
  "success": false,
  "error": {
    "code": "DEVICE_NOT_FOUND",
    "message": "Device not found or access denied"
  },
  "meta": {
    "requestId": "req_5pH1cQbY",
    "timestamp": "2026-04-29T12:00:00.000Z",
    "path": "/hvac/device_unknown_999",
    "latencyMs": 5
  }
}