---
title: "Set the position of a Device"
method: POST
path: "/set-position/{mac-address}"
tags: ["Commands"]
---

# Set the position of a Device

`POST /set-position/{mac-address}`

Set the position of the Device for x, y, z, yaw, pitch and roll. Pica will trigger the
`neighbor-updated` event for every other device present in the scene closer that the maximum distance UINT16_MAX cm.

## 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

- `404` — Device not found
- `500` — Internal error

## Changes

- **2026-07-17** `7e54e3f9ba25` — 1 breaking, 1 warning
  - added required request body
  - deleted the `query` request parameter `position-required`
- **2022-08-22** `657e36b2039b` — 6 info
  - for the `query` request parameter `position-required`, the type of property `pitch` was generalized from `integer` to `number`
  - for the `query` request parameter `position-required`, the type of property `roll` was generalized from `integer` to `number`
  - for the `query` request parameter `position-required`, the type of property `x` was generalized from `integer` to `number`
  - for the `query` request parameter `position-required`, the type of property `y` was generalized from `integer` to `number`
  - …2 more
- **2022-08-05** `657e36b2039b` — 2 breaking
  - added the new required `query` request parameter `position-required`
  - removed the request body
- **2022-07-29** `df1e30abf42d` — 1 breaking, 1 warning
  - added required request body
  - deleted the `query` request parameter `position-required`
- …earlier changes not shown

[Full history](https://skmtc.dev/google/apis/pica-a-platform-agnostic-uwb-virtual-controller/changes/set-position/: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)