> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hyperwisor.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Onboarding

> QR scan, device registration, and user-device management via the Manufacturer API.

These endpoints power the user onboarding flow — scanning a device's QR code and
linking it to a user account. All requests require the
[auth headers](/api/authentication) and are relative to the
[base URL](/api/overview#base-url).

## Scan a QR code

```http theme={null}
POST /onboarding/scan-qr
```

```json theme={null}
{ "qr_data": "<contents of the scanned QR>" }
```

Returns the product info encoded in / resolved from the QR, so the app can show
what's being onboarded before registering.

## Register a device

```http theme={null}
POST /onboarding/device
```

```json theme={null}
{
  "user_id": "the-user-id",
  "product_id": "the-product-id",
  "device_name": "Living Room Sensor",
  "device_identifier": "unique-device-id",
  "qr_info": { }
}
```

Links the device to the user's account.

## List a user's devices

```http theme={null}
GET /onboarding/user/{userId}/devices
```

## Remove a device

```http theme={null}
DELETE /onboarding/device/{deviceId}
```

<Card title="Back to API overview" icon="book" href="/api/overview">
  Base URL, auth, and all endpoint groups.
</Card>
