---
title: "Set Prim Metadata"
method: PUT
path: "/prims/metadata"
tags: ["Prims"]
---

# Set Prim Metadata

`PUT /prims/metadata`

This endpoint adds custom metadata to the given `prim_path`.
That means you can define a `type` and `category` for any `prim_path` from your scene.

In our current API, for tool (category), three types are supported: `GenericGripper`,
`SurfaceGripper` and `Conveyor'. Nevertheless, you can add any string value to `category` and `type` you
wish for.

## Request body

- BodySetPrimMetadata
  - `metadata` CustomPrimData, required
    - `category` string, required
    - `type` string, required
  - `prim_path` string, required — Prim path of the object

## Response `204`

Metadata set successfully

## Other responses

- `404` — Invalid prim path
- `422` — Validation Error
- `500` — Failed to set custom metadata on the prim

---

[API](https://skmtc.net/wandelbotsgmbh/apis/wandelbots-nova-isaac-sim-extension-api.md) · [All operations](https://skmtc.net/wandelbotsgmbh/apis/wandelbots-nova-isaac-sim-extension-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wandelbotsgmbh/wandelbots-nova-isaac-sim-extension-api/versions/a0efd7dad77c/schema)