POST/api/devices/{device_id}/identification

Identify a device

Requests a screen showing the device friendly ID. Rendering runs in the background. The device receives the screen when it next checks in; this does not wake a sleeping device.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

1 parameter
device_idintegerrequired
Device id

4 status codes
202Identification requested
dataobjectrequired
401Unauthorized
errorstringoptional
404Device not found in your account
errorstringoptional
422Device could not be updated
errorstringoptional

Error handling

A 401 is returned: Unauthorized. A 404 is returned: Device not found in your account. A 422 is returned: Device could not be updated.