Create device

Create device

post

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

Authorizations

ApiKeyAuthenticationJWTAuthenticationJWTHttpHeaderAuthenticationOAuth2

Path parameters

projectIdintegerRequired

Project ID

Body

deviceIdstringRequired

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

Example: ac:87:a3:0a:2d:1b

deviceTypestringRequired

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

Example: DISCO_L475VG_IOT01A

ifNotExistsbooleanRequired

Whether to throw an error when this device already exists.

Responses

200

OK

application/json

post

HTTPcURLJavaScriptPython

POST /v1/api/{projectId}/devices/create HTTP/1.1
Host: studio.edgeimpulse.com
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 86

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

200

OK

{
  "success": true,
  "error": "text"
}