---
title: "Demote Entity"
method: POST
path: "/api/v1/ontology/entities/{entity_id}/demote"
tags: ["ontology-promotion"]
---

# Demote Entity

`POST /api/v1/ontology/entities/{entity_id}/demote`

## Request

- Base URL: `https://api.netter.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.netter.ai/api/v1/ontology/entities/{entity_id}/demote`
- Auth: none declared

Tear down an OntologyEntity, leaving its underlying Database intact.

Refuses with 409 when overlays exist — caller must clear them first.

## Path parameters

- `entity_id` string, uuid, required

## Response `204`

Successful Response

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/netter/apis/dmi-backend.md) - [All operations](https://skmtc.dev/netter/apis/dmi-backend/llms.txt) - [OpenAPI document](https://skmtc.dev/netter/apis/dmi-backend/revisions/68e89013efe0?raw)