---
title: "Create an anchor Device in the scene"
method: POST
path: "/create-anchor/{mac-address}"
tags: ["Commands"]
---

# Create an anchor Device in the scene

`POST /create-anchor/{mac-address}`

Create an anchor Device in the scene  with a given MacAddress. If the position is not specified then the anchor will be create at the origin of the scene, [0,0,0,0,0,0]

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

- `406` — Wrong argument
- `409` — Anchor already exist

## Changes

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

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