> ## Documentation Index
> Fetch the complete documentation index at: https://docs.seam.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Setting and Monitoring Temperature Thresholds

> Learn how to use temperature thresholds to monitor your thermostat for potential HVAC system misuse or malfunctioning.

You can configure Seam to emit a [`thermostat.temperature_threshold_exceeded` event](/api/events/object) if a thermostat reports a temperature outside a specific threshold range. This capability helps you to monitor your thermostats proactively, alerting you to potential HVAC system misuse or malfunctioning.

Use the [`/thermostats/set_temperature_threshold`](/api/thermostats/set_temperature_threshold) endpoint to set upper and lower acceptable temperature bounds. Then, you can use a [webhook](../../developer-tools/webhooks) to monitor for `thermostat.temperature_threshold_exceeded` events.

When the thermostat reports a temperature outside the threshold range, Seam also adds a warning on the thermostat. You can use the [`/devices/get`](/api/devices/get) endpoint to get the thermostat and then inspect its `device.warnings` property.

***

## Set a Temperature Threshold

To set a temperature threshold for a thermostat, issue a [`/thermostats/set_temperature_threshold`](/api/thermostats/set_temperature_threshold) request, providing the `device_id` of the desired thermostat. Also, include the following parameters:

* `lower_limit_celsius` or `lower_limit_fahrenheit`
* `upper_limit_celsius` or `upper_limit_fahrenheit`

**Request:**

<CodeGroup>
  ```javascript JavaScript theme={null}
  await seam.thermostats.setTemperatureThreshold({
    device_id: '2d488679-6f07-4810-aed2-e726872c1dd5',
    lower_limit_celsius: 4,
    upper_limit_celsius: 30,
  })
  ```

  ```bash cURL theme={null}
  curl -X 'POST' \
    'https://connect.getseam.com/thermostats/set_temperature_threshold' \
    -H 'accept: application/json' \
    -H "Authorization: Bearer ${SEAM_API_KEY}" \
    -H 'Content-Type: application/json' \
    -d '{
      "device_id": "2d488679-6f07-4810-aed2-e726872c1dd5",
      "lower_limit_celsius": 4,
      "upper_limit_celsius": 30
  }'
  ```

  ```python Python theme={null}
  seam.thermostats.set_temperature_threshold(
    device_id = "2d488679-6f07-4810-aed2-e726872c1dd5",
    lower_limit_celsius = 4,
    upper_limit_celsius = 30
  )
  ```

  ```ruby Ruby theme={null}
  # Coming soon!
  ```

  ```php PHP theme={null}
  $seam->thermostats->set_temperature_threshold(
    device_id: "2d488679-6f07-4810-aed2-e726872c1dd5",
    lower_limit_celsius: 4,
    upper_limit_celsius: 30
  );
  ```

  ```java C# theme={null}
  // Coming soon!
  ```
</CodeGroup>

**Response:**

<CodeGroup>
  ```json JavaScript theme={null}
  void
  ```

  ```json cURL theme={null}
  {
    "ok": true
  }
  ```

  ```json Python theme={null}
  None
  ```

  ```json Ruby theme={null}
  # Coming soon!
  ```

  ```json PHP theme={null}
  void
  ```

  ```json C# theme={null}
  // Coming soon!
  ```
</CodeGroup>

***

## View a Temperature Threshold

The temperature threshold range that you set for a thermostat is a property of the [`thermostat`](/capability-guides/thermostats) resource itself. To view the threshold values, use the [`/devices/get`](/api/devices/get) endpoint and inspect the `thermostat.temperature_threshold`.

**Request:**

<CodeGroup>
  ```javascript JavaScript theme={null}
  await seam.devices.get({
    device_id: 'a4b775e3-feb2-4c6b-8e78-a73ec2d70b61',
  })
  ```

  ```bash cURL theme={null}
  # Use GET or POST.
  curl -X 'GET' \
    'https://connect.getseam.com/devices/get' \
    -H 'accept: application/json' \
    -H 'Authorization: Bearer ${API_KEY}' \
    -H 'Content-Type: application/json' \
    -d '{
    "device_id": "a4b775e3-feb2-4c6b-8e78-a73ec2d70b61"
  }'
  ```

  ```python Python theme={null}
  seam.devices.get(
    device_id = "a4b775e3-feb2-4c6b-8e78-a73ec2d70b61"
  )
  ```

  ```ruby Ruby theme={null}
  # Coming soon!
  ```

  ```php PHP theme={null}
  $seam->devices->get(
    device_id: "a4b775e3-feb2-4c6b-8e78-a73ec2d70b61"
  );
  ```

  ```csharp C# theme={null}
  // Coming soon!
  ```
</CodeGroup>

**Response:**

<CodeGroup>
  ```json JavaScript theme={null}
  {
    device_id: 'a4b775e3-feb2-4c6b-8e78-a73ec2d70b61',
    temperature_threshold: {
      lower_limit_celsius: 4,
      lower_limit_fahrenheit: 39.2,
      upper_limit_celsius: 30,
      upper_limit_fahrenheit: 86
    },
    ...
  }
  ```

  ```json cURL theme={null}
  {
    "device": {
      "device_id": "a4b775e3-feb2-4c6b-8e78-a73ec2d70b61",
      "temperature_threshold": {
        "lower_limit_celsius": 4,
        "lower_limit_fahrenheit": 39.2,
        "upper_limit_celsius": 30,
        "upper_limit_fahrenheit": 86
      },
      ...
    },
    "ok": true
  }
  ```

  ```json Python theme={null}
  Device(
    device_id='a4b775e3-feb2-4c6b-8e78-a73ec2d70b61',
    temperature_threshold={
      lower_limit_celsius: 4,
      lower_limit_fahrenheit: 39.2,
      upper_limit_celsius: 30,
      upper_limit_fahrenheit: 86
    },
    ...
  )
  ```

  ```json Ruby theme={null}
  # Coming soon!
  ```

  ```json PHP theme={null}
  {
    "device_id": "a4b775e3-feb2-4c6b-8e78-a73ec2d70b61",
    "temperature_threshold": {
      "lower_limit_celsius": 4,
      "lower_limit_fahrenheit": 39.2,
      "upper_limit_celsius": 30,
      "upper_limit_fahrenheit": 86
    },
    ...
  }
  ```

  ```json C# theme={null}
  // Coming soon!
  ```
</CodeGroup>

***

## Change a Temperature Threshold

To change the temperature threshold range for a thermostat, issue a new [`/thermostats/set_temperature_threshold`](/api/thermostats/set_temperature_threshold) request. The new threshold values replace the previous ones.

***

## Monitor a Temperature Threshold

To monitor a thermostat for temperatures outside the bounds of the configured threshold range, you can configure a [webhook](../../developer-tools/webhooks) to receive `thermostat.temperature_threshold_exceeded` events. This event includes the `device_id` of the affected thermostat, as well as the configured threshold values and the reported temperature that exceeded this threshold range.

When the reported temperature for a thermostat returns to within the configured threshold range, Seam emits a `thermostat.temperature_threshold_no_longer_exceeded` event.

***

## Delete a Temperature Threshold

To delete the temperature threshold range for a thermostat, issue a `/thermostats/set_temperature_threshold` request, providing either of the following parameter combinations:

* Provide only the `device_id` of the desired thermostat.
* Provide the `device_id` of the desired thermostat and set the following parameters to null:
  * `lower_limit_celsius` or `lower_limit_fahrenheit`
  * `upper_limit_celsius` or `upper_limit_fahrenheit`

<Tabs>
  <Tab title="JavaScript">
    **Request:**

    ```javascript theme={null}
    await seam.thermostats.setTemperatureThreshold({
      device_id: '2d488679-6f07-4810-aed2-e726872c1dd5',
    })
    ```

    or

    ```javascript theme={null}
    await seam.thermostats.setTemperatureThreshold({
      device_id: '2d488679-6f07-4810-aed2-e726872c1dd5',
      lower_limit_celsius: null,
      upper_limit_celsius: null,
    })
    ```

    **Response:**

    ```json theme={null}
    void
    ```
  </Tab>

  <Tab title="cURL">
    **Request:**

    ```bash theme={null}
    curl -X 'POST' \
      'https://connect.getseam.com/thermostats/set_temperature_threshold' \
      -H 'accept: application/json' \
      -H "Authorization: Bearer ${SEAM_API_KEY}" \
      -H 'Content-Type: application/json' \
      -d '{
        "device_id": "2d488679-6f07-4810-aed2-e726872c1dd5"
    }'
    ```

    or

    ```bash theme={null}
    curl -X 'POST' \
      'https://connect.getseam.com/thermostats/set_temperature_threshold' \
      -H 'accept: application/json' \
      -H "Authorization: Bearer ${SEAM_API_KEY}" \
      -H 'Content-Type: application/json' \
      -d '{
        "device_id": "2d488679-6f07-4810-aed2-e726872c1dd5",
        "lower_limit_celsius": null,
        "upper_limit_celsius": null
    }'
    ```

    **Response:**

    ```json theme={null}
    {
      "ok": true
    }
    ```
  </Tab>

  <Tab title="Python">
    **Request:**

    ```python theme={null}
    seam.thermostats.set_temperature_threshold(
      device_id = "2d488679-6f07-4810-aed2-e726872c1dd5"
    )
    ```

    or

    ```python theme={null}
    seam.thermostats.set_temperature_threshold(
      device_id = "2d488679-6f07-4810-aed2-e726872c1dd5",
      lower_limit_celsius = None,
      upper_limit_celsius = None
    )
    ```

    **Response:**

    ```
    None
    ```
  </Tab>

  <Tab title="Ruby">
    **Request:**

    ```ruby theme={null}
    # Coming soon!
    ```

    **Response:**

    ```
    # Coming soon!
    ```
  </Tab>

  <Tab title="PHP">
    **Request:**

    ```php theme={null}
    $seam->thermostats->set_temperature_threshold(
      device_id: "2d488679-6f07-4810-aed2-e726872c1dd5"
    );
    ```

    or

    ```php theme={null}
    $seam->thermostats->set_temperature_threshold(
      device_id: "2d488679-6f07-4810-aed2-e726872c1dd5",
      lower_limit_celsius: null,
      upper_limit_celsius: null
    );
    ```

    **Response:**

    ```json theme={null}
    void
    ```
  </Tab>

  <Tab title="C#">
    **Request:**

    ```java theme={null}
    // Coming soon!
    ```

    **Response:**

    ```json theme={null}
    // Coming soon!
    ```
  </Tab>
</Tabs>