---
title: "Set Robot Overlay Visibility"
method: PUT
path: "/overlays/robot/visibility"
tags: ["Robot Overlay (Experimental)"]
---

# Set Robot Overlay Visibility

`PUT /overlays/robot/visibility`

Show or hide the robot ghost for the given motion group.

## Request body

- RobotOverlayVisibility
  - `motion_group_prim_path` string, required — USD prim path of the motion group.
  - `visible` boolean, required — Whether to show or hide the robot overlay.
  - `joint_positions` number[], nullable — Joint positions in radians. Required when visible is true.

## Response `204`

Successful Response

## Other responses

- `400` — joint_positions required when visible is true
- `422` — Validation Error
- `503` — Overlay not ready

## Changes

- **2026-04-13** `325edd10e0bd` — 1 info
  - endpoint added
- **2025-12-02** `1c198c91dc8e` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/wandelbotsgmbh/apis/wandelbots-nova-isaac-sim-extension-api/changes/overlays/robot/visibility/put.md)

---

[API](https://skmtc.dev/wandelbotsgmbh/apis/wandelbots-nova-isaac-sim-extension-api.md) · [All operations](https://skmtc.dev/wandelbotsgmbh/apis/wandelbots-nova-isaac-sim-extension-api/llms.txt) · [OpenAPI document](https://skmtc.dev/wandelbotsgmbh/apis/wandelbots-nova-isaac-sim-extension-api/revisions/7c68cc61ef01?raw)