---
title: "Change iBeacon settings for devices"
method: PUT
path: "/devices/ibeacon"
tags: ["Device"]
---

# Change iBeacon settings for devices

`PUT /devices/ibeacon`

Update the existing or create new iBeacon settings for multiple devices.

## Request body

- XiqChangeDevicesIbeaconRequest — The request to update the existing device level iBeacon setting or create the new device level iBeacon settings if the devices' Network Policy iBeacon service has been enabled.The update will be effective on all devices or none if one of the devices has Network Policy iBeacon service not enabled.
  - `device_ids` integer[], required — The list of device IDs. Consult ExtremeNetworks documentation for the complete list of devices that support the beacon transmitter. The following are some of the AP devices with the embedded beacon: AP122, AP122X, AP150W, AP245X, AP250, and AP550.
  - `enabled` boolean — Whether to enable the device beacon. Default to true for newly enabled device.
  - `major` integer — Identification of a subset of beacons in a geographical venue. Default to 1 for newly enabled device.
  - `minor` integer — Identification of a beacon in a specific location. Default to 1 for newly enabled device.
  - `power` integer — The transmission power in dBm. Default to -59 for newly enabled device.
  - `enable_monitoring` boolean — Whether to enable monitoring, this field has been deprecated but remains for backwards compatability, renamed to 'enable_ble_scan_ibeacon'.
  - `enable_ble_scan_ibeacon` boolean — Whether to enable BLE Scan iBeacon monitoring.
  - `enable_ble_scan_generic` boolean — Whether to enable BLE Scan Generic monitoring.
  - `enable_cloud_reporting` boolean — Whether the device BLE Scan Cloud Reporting is enabled. Default to true for newly enabled device.
  - `enable_batch_reporting` boolean — Whether the device BLE Scan Batch Reporting is enabled. Default to false for newly enabled device.

## Response `200`

OK

---

[API](https://skmtc.net/extremecloudiq/apis/extremecloud-iq-api.md) · [All operations](https://skmtc.net/extremecloudiq/apis/extremecloud-iq-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/extremecloudiq/extremecloud-iq-api/versions/5ff7ab84e8e8/schema)
