Devices
Bind Device
Bind a device to an end user and receive a device token for 4G uploads
POST
Bind a device to an end user. A device can only be bound to one user at a time. If you need to reassign a device, unbind it first.
When a device is bound, a device token (
dtok_*) is returned. This token enables 4G-equipped devices to upload recordings directly to the Bota API without requiring a companion mobile app.
Authentication
Requires an API key withdevices:write scope.
Path Parameters
The device’s unique identifier (e.g.,
dev_abc123).Request Body
The ID of the end user to bind this device to.
Response
Returns the device object with adevice_token field.
Response Fields
Device Token
Thedevice_token returned in the response is a limited-permission credential that allows the device to:
- Create recordings (
POST /v1/recordings) - Get upload URLs (
POST /v1/recordings/:id/upload-url) - Mark uploads complete (
POST /v1/recordings/:id/upload-complete) - Report device status (
POST /v1/devices/:id/heartbeat) - Refresh its token (
POST /v1/devices/:id/token/refresh)
Device tokens have very limited permissions compared to API keys. They cannot list recordings, access other users’ data, or perform administrative operations.

