---
title: "Init a new uwb subsystem and instantiate an UCI Device"
method: POST
path: "/init-uci-device/{mac-address}"
tags: ["Commands"]
---

# Init a new uwb subsystem and instantiate an UCI Device

`POST /init-uci-device/{mac-address}`

This command should be call by any host wishing to use Pica as an UWB Subsystem and shall be called only once by UCI Device.

## Path parameters

- `mac-address` string, required

## Request body

- Position — The position includes the Cartesian coordinates in cm, and the yaw, pitch, roll angles in degrees.
  - `x` integer — x coordinate in cm
  - `y` integer — y coordinate in cm
  - `z` integer — z coordinate in cm
  - `yaw` integer — yaw in degrees
  - `pitch` integer — pitch in degrees
  - `roll` integer — roll in degrees

## Response `200`

Success

## Other responses

- `403` — Device already initialized
- `500` — Internal error

## Changes

- **2026-07-17** `7e54e3f9ba25` — 1 info
  - endpoint added
- **2022-08-22** `657e36b2039b` — 1 breaking
  - api path removed without deprecation
- **2022-08-05** `657e36b2039b` — 1 breaking
  - api path removed without deprecation
- **2022-07-29** `df1e30abf42d` — 1 info
  - endpoint added
- **2022-07-29** `c76afbc268ba` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/google/apis/pica-a-platform-agnostic-uwb-virtual-controller/changes/init-uci-device/:mac-address/post.md)

---

[API](https://skmtc.dev/google/apis/pica-a-platform-agnostic-uwb-virtual-controller.md) · [All operations](https://skmtc.dev/google/apis/pica-a-platform-agnostic-uwb-virtual-controller/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/pica-a-platform-agnostic-uwb-virtual-controller/revisions/7e54e3f9ba25/schema)