---
title: "Update an Entity Type"
method: PATCH
path: "/v3/entity-types/{typeID}"
tags: ["Entity Types"]
---

# Update an Entity Type

`PATCH /v3/entity-types/{typeID}`

## Path parameters

- `typeID` string, required

## Request body

- EntityTypeUpdateRequestV3 — Request body to update an entity type. Only the fields present are changed. `name` is intentionally not updatable — it is immutable because external references key off it.
  - `description` string — New description.
  - `parentTypeID` string — New parent type public ID (`ety_...`), or an empty string to clear the parent (promote to top-level). Must belong to the same account+environment and may not be the type itself.
  - `attributeSchema` unknown

## Response `200`

The request has succeeded.

- EntityTypeV3 — An EntityType is a customer-defined type in the knowledge-graph taxonomy, scoped to an account+environment. Types may be organised into hierarchies via `parentTypeID`, and may carry per-type structured attribute metadata in `attributeSchema` (for example `{"unit": "mg", "range": [0, 100]}`).
  - `typeID` string, required — Stable public identifier for the entity type (`ety_...`).
  - `name` string, required — Human-facing type name. Unique within an account+environment, and immutable once set.
  - `description` string, required — Optional human-facing note about the type.
  - `parentTypeID` string, required — Public ID (`ety_...`) of the parent type, or an empty string when the type is top-level.
  - `attributeSchema` unknown
  - `createdAt` string, date-time, required — Creation timestamp (RFC 3339).
  - `updatedAt` string, date-time, required — Last-update timestamp (RFC 3339).

---

[API](https://skmtc.dev/bem-team/apis/bem-api.md) · [All operations](https://skmtc.dev/bem-team/apis/bem-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bem-team/bem-api/revisions/a6e4624117c6/schema)