Skip to main content
POST
Registers one finding drawn from the catalog. The backend enforces the clinical rules: one whole-tooth finding per tooth and one per surface (registering another replaces it), sano (healthy) is mutually exclusive with any other finding on the tooth, and the finding must be compatible with the tooth’s dentition. Replaced findings are reported in replacedFindingIds. Every mutation response (create, update, delete) also reports the resulting chart state — version and signature — so the client can reflect a signature invalidation without refetching the chart. If no plannedItems are sent, the finding is pre-filled with the catalog’s suggested treatment. Requires the odontogram feature flag and EMR write access.

​
Path Parameters

​
patientId
string
required
The patient whose chart to edit.

​
Body Parameters

​
toothFdi
number
required
Real FDI tooth number (11–48 permanent, 51–85 temporary).
​
catalogFindingId
string
required
A finding id from the catalog.
​
surface
string
Required for surface-scoped findings: occlusal | mesial | distal | vestibular | palatal.
​
plannedItems
array
Optional. Each item is custom (with name) or clinical_procedure (with clinicalProcedureId), plus quantity and unitPrice.
​
notes
string
Optional free-text note (max 1000 chars).