Devices

Create device

Create a new device. If you set ifNotExists to false and the device already exists, the deviceType will be overwritten.

post/api/{projectId}/devices/create

Request

Path parameters

projectIdinteger required

Project ID

Request body

deviceIdstring required

Globally unique device identifier (e.g. MAC address)

deviceTypestring required

Device type, for example the exact model of the device. Should be the same for all similar devices

ifNotExistsboolean required

Whether to throw an error when this device already exists.

Example request

{
  "deviceId": "ac:87:a3:0a:2d:1b",
  "deviceType": "DISCO_L475VG_IOT01A"
}

Response

OK

successboolean required

Whether the operation succeeded

errorstring

Optional error description (set if 'success' was false)

Changes

No recorded changes to this operation across all 1 revision of this API.