---
title: "Register a new device"
method: POST
path: "/api/devices"
tags: ["Devices"]
---

# Register a new device

`POST /api/devices`

## Request

- Base URL: `https://api.hiyd.ai`
- URL: `https://api.hiyd.ai/api/devices`
- Auth: HTTP bearer

## Request body

- object
  - `device_id` string, required
  - `device_name` string, required
  - `device_type` 'smartwatch' | 'fitness_tracker' | 'smartphone' | 'other', required
  - `model` string
  - `firmware_version` string
  - `battery_level` number

## Response `201`

Device registered successfully

- object
  - `device` Device
    - `id` string, uuid
    - `device_id` string
    - `user_id` string, uuid
    - `device_name` string
    - `device_type` 'smartwatch' | 'fitness_tracker' | 'smartphone' | 'other'
    - `model` string
    - `firmware_version` string
    - `battery_level` number
    - `last_sync_at` string, date-time
    - `status` 'active' | 'inactive' | 'offline'
    - `settings` object
    - `created_at` string, date-time

## Other responses

- `409`: Device already exists

---

[API](https://skmtc.dev/hiyd/apis/hiyd-backend-api.md) - [All operations](https://skmtc.dev/hiyd/apis/hiyd-backend-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hiyd/apis/hiyd-backend-api/revisions/23598d347e1b?raw)