Sign in

v8

latestSwagger 2.02026-07-13120150263.9 KB

Create or update a device

Create a new device.

put/devices/{deviceId}

Path parameters

deviceIdstring required

Unique ID of the device.

Query parameters

api-versionstring required

The version of the API being called.

expandstring

The query parameter for including requested entities in response.

Request body

idstring

Unique ID of the device.

etagstring

ETag used to prevent conflict in device updates.

displayNamestring

Display name of the device.

templatestring

The device template definition for the device.

enabledboolean

Whether the device connection to IoT Central has been enabled.

provisionedboolean

Whether resources have been allocated for the device.

simulatedboolean

Whether the device is simulated.

organizationsstring[]

List of organization IDs that the device is a part of, only one organization is supported today, multiple organizations will be supported soon.

typestring[]

The type of the device.

Response

Success

idstring

Unique ID of the device.

etagstring

ETag used to prevent conflict in device updates.

displayNamestring

Display name of the device.

templatestring

The device template definition for the device.

enabledboolean

Whether the device connection to IoT Central has been enabled.

provisionedboolean

Whether resources have been allocated for the device.

simulatedboolean

Whether the device is simulated.

organizationsstring[]

List of organization IDs that the device is a part of, only one organization is supported today, multiple organizations will be supported soon.

typestring[]

The type of the device.