---
title: "Updates a single sensor rule"
method: PUT
path: "/sensors/v3/{sensorRuleId}"
tags: ["Sensors"]
---

# Updates a single sensor rule

`PUT /sensors/v3/{sensorRuleId}`

Updates the sensor rule `sensorRuleId` name, description and range or threshold.
The sensor rule type cannot be updated.
If some of the these properties are not provided in the request body, their values
will be set to null.
If the sensor rule has been updated successfully, the response will contain the updated rule details.

## Request body

- union
  - object
    - `description` string — Sensor rule description
    - `name` string — Sensor rule name
    - `range` object, required
      - `begin` number, required — A minimum battery sensor alarm threshold value. Must be less than end.
      - `end` number, required — A maximum battery sensor alarm threshold value. Must be greater than begin.
    - `type` 'battery', required — The sensor type.
  - object
    - `description` string — Sensor rule description
    - `name` string — Sensor rule name
    - `range` object, required
      - `begin` number, required — A minimum humidity sensor alarm threshold value. Must be less than end.
      - `end` number, required — A maximum humidity sensor alarm threshold value. Must be greater than begin.
    - `type` 'humidity', required — The sensor type.
  - object
    - `description` string — Sensor rule description
    - `name` string — Sensor rule name
    - `range` object, required
      - `begin` number, required — A minimum pressure sensor alarm threshold value. Must be less than end.
      - `end` number, required — A maximum pressure sensor alarm threshold value. Must be greater than begin.
    - `type` 'pressure', required — The sensor type.
  - object
    - `description` string — Sensor rule description
    - `name` string — Sensor rule name
    - `range` object, required
      - `begin` number, required — A minimum temperature sensor alarm threshold value. Must be less than end.
      - `end` number, required — A maximum temperature sensor alarm threshold value. Must be greater than begin.
    - `type` 'temperature', required — The sensor type.
  - object
    - `description` string — Sensor rule description
    - `name` string — Sensor rule name
    - `type` 'attach' | 'tamper', required — The sensor type.
  - object
    - `description` string — Sensor rule description
    - `name` string — Sensor rule name
    - `threshold` object, required
      - `value` number, required — An acceleration sensor alarm threshold value.
    - `type` 'acceleration', required — The sensor type.

## Response `200`

Successful

The sensor rule was updated.

- object — Response body contains a single sensor rule object
  - `message` string — The message text is "updated" if the sensor rule update was successful.
  - `description` string
  - `id` string, uuid, required — Must be a valid UUIDv4.
  - `name` string
  - `range` object
    - `begin` number, required — The lower threshold value.
    - `end` number, required — The upper threshold value.
  - `threshold` object
    - `value` number, required — Threshold value
  - `type` 'attach' | 'battery' | 'humidity' | 'pressure' | 'tamper' | 'temperature' | 'acceleration', required — The sensor type.

## Other responses

- `400` — Bad request The request object is in an incorrect format or has values that are invalid or out of range. If available, further error details are provided in the response body.
- `401` — Unauthorized The request did not provide correct authentication details
- `403` — Forbidden The account does not have the correct privileges
- `404` — The sensor rule ID was not found

---

[API](https://skmtc.net/here/apis/tracking.md) · [All operations](https://skmtc.net/here/apis/tracking/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/here/tracking/versions/efa162f7023c/schema)