Confirm OTP and Link Device to Organization
Confirm a one-time password, link device to organization, and receive a Device Key.
This endpoint returns a Device Key (4 BIP39 words) that identifies the device. The Device Key is stable: the same device always yields the same key.
Requires X-Org-Key header with a valid Developer Key to link the device to your organization.
Use the Device Key with /api/sessions/v2 to create a session token for API access.
Device Key Format
The Device Key consists of 4 BIP39 words separated by dashes:
Flow
- The user reads the 6-digit OTP from the device display and enters it in your app
- This endpoint validates OTP and links device to your organization
- Returns the Device Key
- Create a session with POST /api/sessions/v2 using your Developer Key
- Use the session token with X-Device-Key header to control the device
Headers
Body
Response
Device linked successfully
Response containing a Device Key (public device identifier). The Device Key is a stable identifier for the device, consisting of 4 BIP39 words.