Skip to main content
POST
/
devices
/
{id}
/
unbind
curl -X POST https://api.bota.dev/v1/devices/dev_abc123/unbind \
  -H "Authorization: Bearer sk_live_..."
{
  "id": "dev_abc123",
  "serial_number": "SN-2025-001234",
  "device_type": "bota_pin_v1",
  "firmware_version": "1.2.0",
  "status": "unbound",
  "end_user_id": null,
  "metadata": null,
  "created_at": "2025-01-15T10:30:00Z",
  "bound_at": null
}
Unbind a device from its current end user, making it available for reassignment. This is a no-op if the device is not currently bound.
id
string
required
The device’s unique identifier (e.g., dev_abc123).
curl -X POST https://api.bota.dev/v1/devices/dev_abc123/unbind \
  -H "Authorization: Bearer sk_live_..."
{
  "id": "dev_abc123",
  "serial_number": "SN-2025-001234",
  "device_type": "bota_pin_v1",
  "firmware_version": "1.2.0",
  "status": "unbound",
  "end_user_id": null,
  "metadata": null,
  "created_at": "2025-01-15T10:30:00Z",
  "bound_at": null
}
Unbinding a device does not affect existing recordings. Recordings remain associated with the end user who was bound at the time of recording.