---
title: "Insert Row"
method: POST
path: "/api/v1/ontology/entities/{entity_id}/rows"
tags: ["ontology-rows"]
---

# Insert Row

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

Insert a row — routed through the entity's default create Action.

## Path parameters

- `entity_id` string, uuid, required

## Request body

- EntityRowInsert
  - `values` object, required — Column → value for the new row. Must be a subset of entity columns.

## Response `201`

Successful Response

- EntityRowRead — One merged row (source ⊕ overlay).
  - `row_key` string, required — Stable identity for this row within the entity.
  - `values` object, required — Column → value, post-merge.
  - `has_overlay` boolean — True if any overlay edits applied to this row.
  - `overlay_only` boolean — True if this row exists only in the overlay (no source counterpart).
  - `source_deleted` boolean — True if the source row vanished after refresh; row is hidden by default.
  - `updated_by` string, uuid, nullable — Last editor (None if no overlay).
  - `updated_at` string, date-time, nullable — Overlay updated_at if an overlay exists.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/netter/apis/dmi-backend.md) · [All operations](https://skmtc.net/netter/apis/dmi-backend/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/netter/dmi-backend/versions/a59877bf911b/schema)