---
title: "Update an existing device"
method: PUT
path: "/v1/device/{deviceId}"
tags: ["Device"]
---

# Update an existing device

`PUT /v1/device/{deviceId}`

A user can only execute this call is he is a member of an authorizing role such that this role has a monitors relation with monitorManagement rights. Alternatively, the user must be member of a set of roles with monitors relations for the specified device, such that the set of device properties which these relations allow to edit are a subset of the device properties which are specified in the current request.

## Path parameters

- `deviceId` union, required
  - integer
  - integer[]

## Query parameters

- `mode` 'strict' | 'legacy' | 'merge'
- `validate` boolean

## Headers

- `If-Unmodified-Since` string

## Request body

- Def7
  - `properties` object, required

## Response `200`

The readable and editable properties of the device, as well as information regarding the editabilities of those properties and whether the user has monitorManagement rights for the device

- object
  - `device` union — The updated device
    - Def8
      - `id` integer, required — Id of the device
      - `lastUpdate` string, required — Last update of the device in server time, formatted as an ISO 8601 string
      - `properties` object, required
      - `userRights` object, required — An object specifying which device properties a user may view or edit
        - `propertyEditabilities` object, required
        - `monitorManagement` boolean, required
    - Def8[]
      - `id` integer, required — Id of the device
      - `lastUpdate` string, required — Last update of the device in server time, formatted as an ISO 8601 string
      - `properties` object, required
      - `userRights` object, required — An object specifying which device properties a user may view or edit
        - `propertyEditabilities` object, required
        - `monitorManagement` boolean, required

## Other responses

- `400` — Invalidly formatted body or query parameter
- `401` — Authentication required or token invalid
- `412` — At least one of the affected devices was updated after the specified time

---

[API](https://skmtc.dev/eniris/apis/eniris-metadata-telemetry-query-api.md) · [All operations](https://skmtc.dev/eniris/apis/eniris-metadata-telemetry-query-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/eniris/eniris-metadata-telemetry-query-api/revisions/fe3723575e19/schema)