---
title: "Updates a device."
method: PUT
path: "/devices/{id}"
tags: ["Devices"]
---

# Updates a device.

`PUT /devices/{id}`

## Path parameters

- `id` string, required

## Request body

- DeviceRequest — Request model used for creating and updating devices in the RevelDigital platform. Contains the mutable properties that can be set when registering or modifying a device.
  - `name` string, nullable — The device name
  - `tags` string, nullable — Tags associated with this device
  - `timeZone` string, nullable — The timezone of the device
  - `language_code` string, nullable — The language code of the device
  - `group_id` string, nullable — The group id
  - `last_service` string, date-time, nullable — The last service date
  - `mac_address` string, nullable — The MAC address of this device, is applicable
  - `location` Location
    - `city` string, nullable — City
    - `state` string, nullable — State
    - `county` string, nullable — County
    - `country` string, nullable — Country
    - `postal_code` string, nullable — Postal code
    - `address` string, nullable — Address
    - `latitude` number, double, nullable — Latitude
    - `longitude` number, double, nullable — Longitude
  - `beacon` Beacon — Represents Bluetooth Low Energy (BLE) beacon configuration for a device. Beacons enable proximity-based interactions, allowing mobile devices to detect nearby digital signage and trigger location-aware content or notifications.
    - `distance` number, double, nullable — The detection distance threshold in meters. Mobile devices within this range will receive beacon notifications.
    - `calibration` number, double, nullable — The RSSI calibration value (measured power at 1 meter) used for distance estimation. This value is typically negative (e.g., -59 dBm) and device-specific. Accurate calibration improves proximity zone detection accuracy.
    - `phone` string, nullable — Contact phone number associated with this beacon location. Displayed to users who interact with the beacon via mobile app.
    - `emailAddress` string, nullable — Contact email address associated with this beacon location. Displayed to users who interact with the beacon via mobile app.
    - `website` string, nullable — Website URL associated with this beacon location. Can be opened by mobile app when user interacts with beacon notification.
    - `devices` string[], nullable — List of device IDs associated with this beacon configuration. Used for grouping multiple devices that share the same beacon identity.
    - `rating` number, double, nullable — Rating value for this beacon location (e.g., customer rating, priority score). Can be used to rank or filter beacon-triggered content.
    - `uuid` string, nullable — The iBeacon UUID (Universally Unique Identifier). A 128-bit identifier typically shared by all beacons in an organization. Format: "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
    - `major` string, nullable — The iBeacon Major value (0-65535). Typically used to identify a specific location or venue within an organization.
    - `minor` string, nullable — The iBeacon Minor value (0-65535). Typically used to identify a specific beacon within a location.
    - `notification_delay` integer, nullable — Delay in seconds before sending a notification after beacon detection. Prevents notification spam when users briefly pass by a beacon. A value of 0 or null means immediate notification.
    - `instance_id` string, nullable — The Eddystone Instance ID (6 bytes, 12 hex characters). Identifies a specific beacon within an Eddystone namespace.
    - `namespace` string, nullable — The Eddystone Namespace ID (10 bytes, 20 hex characters). Typically derived from a domain name or organization identifier.

## Response `204`

No Content

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/reveldigital/apis/revel-digital-rest-api.md) · [All operations](https://skmtc.net/reveldigital/apis/revel-digital-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/reveldigital/revel-digital-rest-api/versions/f23a94aea621/schema)
