---
title: "Sync Entity"
method: POST
path: "/api/v1/ontology/entities/{entity_id}/sync"
tags: ["ontology-rows"]
---

# Sync Entity

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

Trigger a source sync for the entity.

Write-gated: sync triggers a DuckDB scan over S3, which is expensive
enough that low-privilege viewers shouldn't be able to fire it in a
tight loop.  Same write-role guard the other row endpoints use.

## Path parameters

- `entity_id` string, uuid, required

## Response `200`

Successful Response

- EntitySyncStatus
  - `last_synced_at` string, date-time, nullable, required
  - `source_row_count` integer, required
  - `overlay_count` integer, required
  - `state` string, required — 'idle' | 'syncing' | 'error'

## 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/revisions/a59877bf911b/schema)