Register a new device
Dashboard-only
DeviceGrant), and use the Device Control endpoints.Creates the device record in a PENDING state with no MQTT credentials yet call "Generate credentials" separately before it can connect.
Authorization
sessionAuth A session token for an existing account, obtained from POST /auth/login (see the Authentication endpoints) - not an API key. Endpoints marked with this scheme reject API key callers outright, regardless of what that key is granted. Outside the Authentication endpoints themselves, everything requiring this scheme manages dashboard resources (schedules, rules, grants, keys, device configuration) and mirrors what a human does in the Nexalware web app - it is not meant to be automated by a third-party integration the way the Device Control endpoints are.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
curl -X POST "https://example.com/api/v1/devices/register" \ -H "Content-Type: application/json" \ -d '{ "name": "string", "boardType": "string", "appType": "string" }'{ "deviceId": "string"}