---
title: "Update meter"
method: PATCH
path: "/meters/{id}"
tags: ["Meters"]
---

# Update meter

`PATCH /meters/{id}`

## Path parameters

- `id` integer, required

## Query parameters

- `skipWebhook` boolean

## Request body

- object
  - `assetId` integer, nullable — Global ID of the asset tied to the meter
  - `locationId` integer, nullable — Global ID of the location tied to the meter
  - `description` string, nullable — Description of the meter
  - `name` string — Name of the meters
  - `readingFrequency` union — Expected reading frequency of the meter. Mostly useful for manual meters.
    - object, nullable
      - `type` 'SECONDLY', required
      - `interval` integer — Number of seconds between readings. Minimum 10s for IOT_DEVICE, 86400s for MANUAL
    - object, nullable
      - `type` 'MINUTLY', required
      - `interval` integer — Number of minutes between readings
    - object, nullable
      - `type` 'HOURLY', required
      - `interval` integer — Number of hours between readings
    - object, nullable
      - `type` 'DAILY', required
      - `interval` integer — Number of days between readings
    - object, nullable
      - `type` 'WEEKLY', required
      - `interval` integer — Number of weeks between readings
      - `days` string[] — Days of the week the event will occur
    - object, nullable
      - `type` 'MONTHLY', required
      - `interval` integer — Number of months between readings
      - `day` integer — Day of the month the event will occur
    - object, nullable
      - `type` 'YEARLY', required
      - `interval` integer — Number of years between readings
  - `unit` string — Measurement unit for the readings. Any string is accepted. However, if applicable, we recommed you to use the following units as it may carry extra functionality: <br><ul> <li>Distance: <ul> <li><code>Miles</code></li><li><code>Feet</code></li><li><code>Inches</code></li><li><code>Kilometers</code></li><li><code>Meters</code></li><li><code>Centimeters</code></li><li><code>Millimeters</code></li> </ul> </li> <li>Volume: <ul> <li><code>Gallons</code></li><li><code>Liters</code></li><li><code>Milliliters</code></li><li><code>Cubic Meters</code></li> </ul> </li> <li>Temperature: <ul> <li><code>Celsius</code></li><li><code>Fahrenheit</code></li><li><code>Kelvin</code></li> </ul> </li> <li>Other: <ul> <li><code>Hours</code></li><li><code>Cycles</code></li><li><code>PSI</code></li><li><code>Kilograms</code></li><li><code>Grams</code></li><li><code>dBm</code></li><li><code>Nm</code></li> </ul> </li> <li>Velocity: <ul> <li><code>MetersPerSecond</code></li><li><code>InchesPerSecond</code></li><li><code>MillimetersPerSecond</code></li> </ul> </li> <li>Acceleration: <ul> <li><code>G-Force</code></li><li><code>MetersPerSecondSquared</code></li><li><code>FeetPerSecondSquared</code></li> </ul> </li> <li>Electrical: <ul> <li><code>Volts</code></li><li><code>Amps</code></li> </ul> </li> </ul>

## Response `200`

Successfully edited meter

- object
  - `meter` object, required
    - `id` number, required — Global ID of the meter.
    - `assetId` integer, nullable — Global ID of the asset tied to the meter
    - `locationId` integer, nullable — Global ID of the location tied to the meter
    - `creatorId` integer — Global ID of the user who created the meter
    - `updaterId` integer, nullable — Global ID of the last user who updated the meter
    - `name` string, required — Name of the meters
    - `uuid` string — Universally unique identifier of the meter in the UUID format
    - `description` string, nullable — Description of the meter
    - `measurementType` 'MANUAL' | 'IOT_DEVICE' | 'AUTOMATED_SENSOR' — Represents the Type of meter. <br><br><code>Manual</code>: They are made to be used in the MaintainX app and to retain manually entered values and are limited to 10 distinct readings creation requests per 24 hours over REST API. Batched readings requests only count as one toward the rate limit. <br><br><code>Automated</code>: (Enterprise Plan) Automated meters store high frequency readings sent from integrations and have normal rate limiting. <br><br>~~<code>IoT Device</code>~~: IoT Device meters are deprecated and should no longer be used in the future. Creating an IoT Device meter will mimic automated meters in terms of behavior to avoid breaking changes.
    - `readingFrequency` union — Expected reading frequency of the meter. Mostly useful for manual meters.
      - object, nullable
        - `type` 'SECONDLY', required
        - `interval` integer — Number of seconds between readings. Minimum 10s for IOT_DEVICE, 86400s for MANUAL
      - object, nullable
        - `type` 'MINUTLY', required
        - `interval` integer — Number of minutes between readings
      - object, nullable
        - `type` 'HOURLY', required
        - `interval` integer — Number of hours between readings
      - object, nullable
        - `type` 'DAILY', required
        - `interval` integer — Number of days between readings
      - object, nullable
        - `type` 'WEEKLY', required
        - `interval` integer — Number of weeks between readings
        - `days` string[] — Days of the week the event will occur
      - object, nullable
        - `type` 'MONTHLY', required
        - `interval` integer — Number of months between readings
        - `day` integer — Day of the month the event will occur
      - object, nullable
        - `type` 'YEARLY', required
        - `interval` integer — Number of years between readings
    - `unit` string — Measurement unit for the readings. Any string is accepted. However, if applicable, we recommed you to use the following units as it may carry extra functionality: <br><ul> <li>Distance: <ul> <li><code>Miles</code></li><li><code>Feet</code></li><li><code>Inches</code></li><li><code>Kilometers</code></li><li><code>Meters</code></li><li><code>Centimeters</code></li><li><code>Millimeters</code></li> </ul> </li> <li>Volume: <ul> <li><code>Gallons</code></li><li><code>Liters</code></li><li><code>Milliliters</code></li><li><code>Cubic Meters</code></li> </ul> </li> <li>Temperature: <ul> <li><code>Celsius</code></li><li><code>Fahrenheit</code></li><li><code>Kelvin</code></li> </ul> </li> <li>Other: <ul> <li><code>Hours</code></li><li><code>Cycles</code></li><li><code>PSI</code></li><li><code>Kilograms</code></li><li><code>Grams</code></li><li><code>dBm</code></li><li><code>Nm</code></li> </ul> </li> <li>Velocity: <ul> <li><code>MetersPerSecond</code></li><li><code>InchesPerSecond</code></li><li><code>MillimetersPerSecond</code></li> </ul> </li> <li>Acceleration: <ul> <li><code>G-Force</code></li><li><code>MetersPerSecondSquared</code></li><li><code>FeetPerSecondSquared</code></li> </ul> </li> <li>Electrical: <ul> <li><code>Volts</code></li><li><code>Amps</code></li> </ul> </li> </ul>
    - `createdAt` string — Meter creation date.
    - `updatedAt` string — Date that Meter was last modified.
    - `deletedAt` string, date-time, nullable — Date at which the meter was deleted.

## Other responses

- `401` — Invalid token
- `404` — Could not find the specified location.

---

[API](https://skmtc.net/getmaintainx/apis/maintainx-api.md) · [All operations](https://skmtc.net/getmaintainx/apis/maintainx-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getmaintainx/maintainx-api/revisions/ef9153fcac7c/schema)