---
title: "Create Markers"
method: POST
path: "/trajectories/{name}/markers"
tags: ["Trajectory"]
---

# Create Markers

`POST /trajectories/{name}/markers`

Adds visual markers along a trajectory.

## Path parameters

- `name` string, required — Name of the trajectory to add markers to

## Request body

- TrajectoryMarker
  - `prim` union, required
    - GizmoPrim
      - `type` 'gizmo', required — Use gizmo marker
    - CustomPrim
      - `type` 'custom', required — Use a custom USD prim as marker
      - `custom_prim_path` string, required — Path to the custom USD prim
    - SpherePrim
      - `type` 'sphere', required — Use a colored sphere as marker
      - `radius` number — Sphere radius in mm
      - `color` unknown[] — RGB color, 0-255 each
        - unknown
  - `poses` array[] — List of cartesian poses to places markers at (example: triangle corners)
    - number[]

## Response `204`

Successful Response

## Other responses

- `404` — Trajectory not found
- `422` — Validation Error
- `500` — Unable to create trajectory markers

## Changes

- **2026-09-17** `7c68cc61ef01` — 2 info
  - added `sphere` discriminator mapping keys to the `prim` request property
  - added `#/components/schemas/SpherePrim` to the `prim` request property `oneOf` list

[Change history](https://skmtc.dev/wandelbotsgmbh/apis/wandelbots-nova-isaac-sim-extension-api/changes/trajectories/:name/markers/post.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)